URLs of Documents' Loc/Ids

[eugenk]

First of all, you may need the class diagram from the wiki to follow this issue. This issue builds on #9 (comment) but it should be self-contained.

I have some questions regarding Loc/Ids of Library and NativeDocument (both of which are subclasses of Document) and their contents: What routes do we want to have for the two, especially NativeDocument? (I left out the /:user/:repository[/rev/:revision] part of the route in the tables)

Type	Library	NativeDocument Option 1
Document	/oms/:library	/oms/:library
OMS	/oms/:library//:oms	/oms/:library//:oms
Symbol	/symbols/:library//:oms//:symbol	/symbols/:library//:oms//:symbol
Sentence	/sentences/:library//:oms//:sentence	/sentences/:library//:oms//:sentence
Mapping	/mappings/:library//:mapping	/mappings/:library//:mapping

Type	Library	NativeDocument Option 2
Document	/oms/:library	/oms/:library
OMS	/oms/:library//:oms	/oms/:oms
Symbol	/symbols/:library//:oms//:symbol	/symbols/:oms//:symbol
Sentence	/sentences/:library//:oms//:sentence	/sentences/:oms//:sentence
Mapping	/mappings/:library//:mapping	/mappings/:library//:mapping

The difference of Library (e.g. DOL) and NativeDocument (e.g. OWL) is that a Library can contain any number of OMS while the NativeDocument contains exactly one OMS.

Do we want to have a separate page for a NativeDocument that serves as an overview page (even though there is not much to show)?

Do we want to use a different namespace for a Document? (/document/:library instead of /oms/:library)

Notes:

• :library may be equal to :oms which leads to URLs like this in option 1
  http://ontohub.org/admin/test-repository/symbols/pizza//pizza//Margherita
  whereas option 2 would look like
  http://ontohub.org/admin/test-repository/symbols/pizza//Margherita
• Option 1 is more uniform across the application because it does not treat NativeDocument any different from Library.
• Option 2 could be more intuitive to the user because an OMS is actually not structured inside a document (considering the URL).

Which option works best with linked open data? What URL does a user want to see when they want to query an OMS/Sentence/Symbol/Mapping in a NativeDocument? (maybe @fabianneuhaus can answer this the best)

Ping @tillmo.

[tillmo]

I am in favour of the second option, because the first option always leads to a duplication (or do you have an example where :library and :oms would be different?), and a user not knowing DOL would not understand the reason for this duplication. (Still, such a user could use Ontohub for her/his native OMS.) For the same reason, I think that we do not need a separate overview page, because this also would just be a duplication.

[phyrog]

Can this be closed?