Move to a technology like Hugo that allows us to generate content in markdown. Also, look into providing the option to download as a PDF or generate one page with all docs.
Requirements
Should be reasonably fast. Our docs have grown and will only continue to grow, so we should keep this in the back of our minds.
Motivation
Myself and others in the team are not fans of Restructured Text and would much prefer it if content were in Markdown, this is pretty standard nowadays. Additionally, there seems to be issues with the search function and organization. This would be a good time to reorganize everything and make docs as easy to navigate as possible.
Alternatives considered
Could go with some existing knowledge base software, but why?...
Project/idea summary
Move to a technology like Hugo that allows us to generate content in markdown. Also, look into providing the option to download as a PDF or generate one page with all docs.
Requirements
Motivation
Myself and others in the team are not fans of Restructured Text and would much prefer it if content were in Markdown, this is pretty standard nowadays. Additionally, there seems to be issues with the search function and organization. This would be a good time to reorganize everything and make docs as easy to navigate as possible.
Alternatives considered
Could go with some existing knowledge base software, but why?...