Diagram https://drive.google.com/file/d/0BwgPHAjIDESYSlFpQlpCaGU0bEk/view?usp=sharing
,
Map is available at:
https://drive.google.com/file/d/0BwgPHAjIDESYSlFpQlpCaGU0bEk/view?usp=sharing
(To view the full size chart click “Open” at the top
, ; you will have to enable the Draw.Io app to access your Google Drive account.)
Notes:
Summary of issues that may need to be addressed
Links from the ArchivesSpace website
to
GitHubio for primary documentation- Confusing for users who will think these are two different documentation sites, plus GitHub.com sometimes links to different content than GitHub.io.
- If someone stumbles on the GitHub.com version because they’re looking at the source code, that’s fine, but we should try to avoid linking there directly (unless linking to actual code)
- Top and left yellow boxes are sections of main GitHub.com readme. Right hand yellow boxes have their own GitHub.com pages.
- Yellow boxes with thick borders are mirrored on GitHub.io. If a bolded box has no arrow pointing to it, we are good (it means the content is available on GitHub.io and no one is linking to the GitHub.com version).
- AS website top menu
- System requirements
- Getting started
- Contributor License Agreement (links to directory of GitHub files – pretty ugly)
- GitHub.io version
- Has internal links to GitHub.com version instead of its own (represented by red arrows):
- Running AS a Windows Service (links to Tomcat and Mysql)
- Upgrading to new release (links to main GitHub.com version of documentation and Tomcat)
- Has internal links to GitHub.com version instead of its own (represented by red arrows):
com documentation
- On top menu
Links from github.io documentation to github.com documentation
- Running ArchivesSpace as a Windows Service
- Upgrading to a new release of ArchivesSpace
- https://github.com/archivesspace/archivesspace/blob/master/UPGRADING_1.1.1.md
- https://github.com/archivesspace/archivesspace/blob/master/UPGRADING_1.1.0.md
- https://github.com/archivesspace/archivesspace/blob/master/README.md
- https://github.com/archivesspace/archivesspace/blob/master/README_TOMCAT.md (broken)
- http://archivesspace.github.io/archivesspace/user/tuning-archivesspace/
“Orphaned” Github.com content (not displayed on IO or linked from anywhere else)
Should be reviewed to see if they need to be kept, and if so, where they should be linked from
- Further documentation
- Mismatched content (red border):
- Running under a prefix
- GitHub.io and GitHub.com both have pages titled “Running ArchivesSpace under a prefix”, but content is different
- Plugins and local customizations
- GitHub.com has two Plugins docs: one is a section of the main readme, the other is a separate page.
- Only the separate page is mirrored on GitHub.io, section of readme should be deleted?
- Running under a prefix
- License
- Credits
- Plug-ins and local customizations (section of master README; plugins has its own separate README, which is used in the IO documentation
Broken Links
- On http://archivesspace.github.io/archivesspace/user/upgrading-to-a-new-release-of-archivesspace/
- On http://archivesspace.github.io/archivesspace/user/running-archivesspace-under-tomcat/ - Link to Solrtuning-archivesspace/