You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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)
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.
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)/oms/:library
/oms/:library
/oms/:library//:oms
/oms/:library//:oms
/symbols/:library//:oms//:symbol
/symbols/:library//:oms//:symbol
/sentences/:library//:oms//:sentence
/sentences/:library//:oms//:sentence
/mappings/:library//:mapping
/mappings/:library//:mapping
/oms/:library
/oms/:library
/oms/:library//:oms
/oms/:oms
/symbols/:library//:oms//:symbol
/symbols/:oms//:symbol
/sentences/:library//:oms//:sentence
/sentences/:oms//:sentence
/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 1http://ontohub.org/admin/test-repository/symbols/pizza//pizza//Margherita
whereas option 2 would look like
http://ontohub.org/admin/test-repository/symbols/pizza//Margherita
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.
The text was updated successfully, but these errors were encountered: