biolink-model icon indicating copy to clipboard operation
biolink-model copied to clipboard

Generated UML diagrams are too busy

Open deepakunni3 opened this issue 5 years ago • 4 comments

Ex: https://biolink.github.io/biolink-model/docs/GeneToExpressionSiteAssociation.html

Certain elements in the diagram are not properly legible.

deepakunni3 avatar Jul 18 '18 20:07 deepakunni3

Need some advice on how to clarify. Bigger diagram? Omit inherited properties and/or associations? One frustrating thing is that YUML isn't really great on multiple arcs , so the three GeneToExpressionSiteAssociation to OntologyClass links are difficult to read.

hsolbrig avatar Jul 19 '18 15:07 hsolbrig

If the three arcs have identical labels, (I cant tell) just keep one and make it heavier if possible

TomConlin avatar Jul 23 '18 17:07 TomConlin

All three arcs have different labels:

  1. gene to expression site association.quantifier qualifier
  2. association type
  3. qualifiers

All of the information in the graph is also available in the text -- perhaps we could organize the text to help. Another example of an unreadable diagram (at leas un-magnified) is https://biolink.github.io/biolink-model/docs/Association.html. The alternative here would appear to be a single box "Association" with all children omitted...

Suggestions?

hsolbrig avatar Jul 24 '18 20:07 hsolbrig

Ex: https://biolink.github.io/biolink-model/docs/GeneToExpressionSiteAssociation.html

Certain elements in the diagram are not properly legible.

The font is small, but (just barely) readable. Is this still something that's viewed as needing improvement? (Not sure it's very high priority, regardless.)

nlharris avatar Apr 27 '21 17:04 nlharris