Feature #1751
closed
Manual: add model documentation
Description
As I add CIDOC CRM classes to the manual at the moment I was wondering if there is documentation for the shortcuts OA8 (begins in) and OA9 (ends in) that I can link to? I was not able to find anything on the model page (https://thanados.openatlas.eu/overview/model) nor the OpenAtlas class index (https://thanados.openatlas.eu/overview/model/openatlas_class_index). If there is nothing like that yet, should we add the information somewhere?
Furthermore, in the archaeological hierarchy model (https://thanados.openatlas.eu/static/images/model/openatlas_schema2.png) E22 is named man-made object (artifact) while E22 is actually named Human-Made Object according to the CIDOC CRM definitions 7.1.1. Maybe we should update this as well?
Updated by Alexander Watzinger over 2 years ago
- Category set to UI
- Status changed from New to In Progress
- Assignee set to Nina Richards
As for documentation of CIDOC shortcuts we are using, you find them here: https://redmine.openatlas.eu/projects/uni/wiki/CIDOC_CRM_shortcuts
But before linking this in the manual you should definitely check with Stefan, who is documenting these, before.
Just to be save we might should consider adding these texts to the manual as a precaution to prevent outdated links in the future.
As for the wrong label for E22 in the model image: thanks for reporting, I fixed it in develop.
Updated by Nina Richards over 2 years ago
I checked in with Stefan this morning and according to him, the OA shortcuts are still up to date. So, if that's okay for everyone, I would put a short text about them into the manual next time I'm working on it and provide links where fitting in the manual.
Updated by Alexander Watzinger over 2 years ago
- Related to Feature #1701: Manual: added API documentation added
Updated by Alexander Watzinger over 2 years ago
- Tracker changed from Question to Feature
- Subject changed from OpenAtlas Shortcuts OA8 and OA9 to Model documentation in manual
- Target version set to 7.5.0
- Better readability and accessibility
- Documentation is always corresponding to used software version
- No danger of outdated links to Redmine
As for implementation I would suggest a new main menu item Model and merging there the existing manual model page and the first Redmine page OpenAtlas_and_CIDOC_CRM, with the other sites as sub pages.
After this move we could do the same with the API documentation and so would have a clean separation with the manual as central documentation and Redmine for planning (issues, roadmap) and operative (e.g. online versions) related information.
Thank you very much for taking care of this. Although very important, the model documentation was done around 2020 and (beside minor cosmetic updates from me) not actively maintained.
Updated by Alexander Watzinger over 2 years ago
- Category changed from UI to Documentation
Updated by Alexander Watzinger over 2 years ago
- Target version changed from 7.5.0 to 7.7.0
Updated by Alexander Watzinger over 2 years ago
- Subject changed from Model documentation in manual to Manual: add model documentation
Updated by Stefan Eichert over 2 years ago
The shortcuts are described in the archive: https://redmine.craws.net/projects/uni/wiki/CIDOC-Mappings
Updated by Nina Richards over 2 years ago
- Status changed from In Progress to Resolved
Updated by Alexander Watzinger over 2 years ago
- Status changed from Resolved to In Progress
There seem to be still dates and references model documentation missing, see: https://redmine.openatlas.eu/projects/uni/wiki/Model_and_concept
But it looks very nice already and I'm looking forward to it. Thank you for time and effort.
Updated by Nina Richards about 2 years ago
- Status changed from In Progress to Resolved
Updated by Nina Richards about 2 years ago
- Status changed from Resolved to Closed