OLAC Documentation is a set independently evolving documents with their own version numbers. What if these documents evolved together in sync? would it make the process more manageable? What if the documentation looked different? More like modern documentation?
I like the following document presentation layouts:
https://github.com/bep/docuapi
https://github.com/matcornic/hugo-theme-learn
https://github.com/alex-shpak/hugo-book
https://github.com/google/docsy
https://github.com/h-enk/doks
Next step is to take the most recent versions of OLAC documents and convert them to markdown. This converter catches all the XML tags while others don't https://codebeautify.org/html-to-markdown
On the list are:
http://www.language-archives.org/OLAC/repositories.html
http://www.language-archives.org/OLAC/metadata.html
http://www.language-archives.org/REC/bpr.html
http://www.language-archives.org/REC/olac-extensions.html
And each of the extensions.
These need to be cast one way for devs and implementers of technology while another way for managers and archivists.