Re: an architectural diagram

Hi Asbjørn,

> How do you feel about using PlantUML[1] as the language to describe
> this and eventually all diagrams in Hydra?

I'm not against, but:
– it seems too simple (at least for the current high-level diagram)
– unsure if UML and OWL are a good match

> I just find plain text to be a
> lot simpler as a versionable piece of information than binary images.

So do I, that's why I made the diagram in plain text, too :-)

> As I think we agreed in our discussion regarding this before
> Christmas, this separation makes sense.

Good, this diagram is a step in making it more concrete.

> While I think it's important that what's common between
> API documentation and hypermedia controls should be designed and named
> in a common way

Indeed; hope the diagram helps with that as well.

Ruben

Received on Tuesday, 3 January 2017 12:35:00 UTC