Added detailed hydra description with OWL vocabulary

[alien-mcl]

This pull request comes with a minor extension that adds detailed hydra description created in OWL.

Feel free to deliberate more on those descriptions.

[tpluscode]

I don't like it. It looks like you simply search/replaced the OWL to become SHACL, but shapes would be different, used differently, and serve different purpose than OWL constraints.

I propose we even take a step back there and go class-by-class. As is, the document is a little large to try and review in a meaningful manner. My proposal would be begin with hydra:ApiDocumentation's shape first and follow the vocabulary to add the rest in subsequent PRs

[alien-mcl]

No - it was not the case. Both OWL and SHACL versions were written from scratch separately, but were put against each other to have i.e. cardinalities in sync.

My entry point was a Hydra rewritten to turtle notation (I'll make a separate PR for that in Specification repo) and then class by class, predicate by predicate both OWL restrictions and SHACL shapes were created. It may look similar though as the order of the terms is the same (due to fact of using same entry point).

I also totaly disagree to move in a PR per term basis - it'll take ages while the task is quite simple. I may consider separating OWL and SHACL though.

[alien-mcl]

BTW, is there any list of valid statuses bikeshed accepts? The spec does not enumerate any and existing specifications are not using two letter derivatives.

[tpluscode]

It is not a simple task, as evidenced by this PR. I cannot really comment on the OWL but there is much to improve in SHACL and it will be much more productive to start small and progress gradually

I think you're looking for https://tabatkins.github.io/bikeshed/#metadata-status?

[alien-mcl]

Hmm - I think it's as simple as creating old school pseudo classes, but not with a programming language but with other means. Let us not over-engineer it.

I see that I'll have to make OWL and SHACL separated to make it simpler.

[alien-mcl]

I've moved SHACL to separate PR leaving OWL alone.

[tpluscode]

The changes got lost here too 🤔

[alien-mcl]

Ok - I've recovered all changed files as these were ... ignored :/

[tpluscode]

I think I should "tentatively" approve this. As I said, I feel that this is too big and it's hard to review and verify correctness.

That said I do not intend to actually work on the OWL representation anyway in the foreseeable future...