Open lanthaler opened 10 years ago
My main problem with this illustration is that the semantics of the horizontal and vertical axis is not obvious (if there is any :-).
What exactly do you mean by "horizontal and vertical axis”?
@lanthaler It is not obvious why an entity is shown to the left or right or above or below another entity in the graphic. For example: some superclasses are above and some are shown below a subclass. And some superclasses are to the left while others are to the right of a subclass.
Oh OK, I see. The position is arbitrary.. it doesn’t have any meaning. Is there any notation where it has?
@lanthaler Just use one main direction: left to right or top to bottom to position the entities.
A further suggestion: move Collection and PagedCollection to a separate illustration if they are not linked to the rest.
_Proposal by @jindrichmynarz:_
How about improving it by having 2 diagrams:
- Higher-level (really "at a glance") diagram depicting the main classes that correspond to the (new) structure of the Hydra specification.
- Detailed diagram (like the current one) depicting the (almost) complete Hydra vocabulary.
+1. It seems like the spec is forming into fairly discrete components(?), and it may be good to have a diagram per component. At first, start with the basic building blocks, and then give the "big picture" at the end.
I think it would make more sense and be less intimidating if the figure was in an appendix. You can say "if you're already familiar with RDF and vocabularies, please check the appendix for a picture giving an overview", or something.
_This was raised by László Lajos Jánszky:_