Need better documentation (with more examples) to explain LinkML to new users

[mszulcz-mitre]

Is your feature request related to a problem? Please describe.
I'd like to use LinkML but I don't understand all its features.

Describe the solution you'd like
I'd like expanded documentation with examples. Currently, the following keywords and concepts are not clear to me:

• domain
• rank
• is_subset
• emit_prefixes
• predicate slots (mentioned here)
• logical characteristics: transitive, symmetric, antisymmetric, reflexive, locally_reflexive

I've read the available documentation and reviewed examples, but I don't understand why theses concepts and keywords are useful or when to use them.

How important is this feature? Select from the options below:
• Medium - can do work without it; but it's important (e.g. to save time or for convenience)

When will use cases depending on this become relevant?
• Short-term - 2-4 weeks

Additional context
I like LinkML but I've been struggling to understand how to use it for a while. Expanded documentation with more examples would probably help gain users.

[nlharris]

Hi @mszulcz-mitre, thanks for your interest in LinkML, and thanks for filing this issue. We are aware that the documentation has room for improvement, and we agree with you that adding examples would be helpful. We currently have very limited person-time to work on LinkML but are hoping that will improve in the near future!

In the meantime, we encourage you to join our LinkML community channel and ask specific questions there (though "Explain LinkML to me" may not get you what you're hoping for 🙂)