Resetting OLAC Documentation

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.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.