07-07-2024, 05:36 PM
Inspired by @proxemics' post, I made a first pass at moving the manual to Markdown on GitHub: https://github.com/martica/nerdseq_manual.
There is still some cleanup to do as the converter is lossy and markdown can't do everything that the existing document format does. It does feel feasible to bring this version up to parity with the existing manual and then leverage the community interest to improve things so I'm going to keep working on it and try to get all the pages formatted nicely to match the existing manual as best I can and into a state where people can make contributions.
I am already feeling that Markdown's limitations may become an issue. HTML on GitHub Pages would provide a lot more flexibility but would also make the barrier to entry higher for contributions.
@XORadmin: This is all your work, so please let me know if you would prefer that I pass ownership of the repo to you, or just remove it if it isn't what you'd like to see. I don't want this to end up making more work for you so please let me know if I've overstepped.
There is still some cleanup to do as the converter is lossy and markdown can't do everything that the existing document format does. It does feel feasible to bring this version up to parity with the existing manual and then leverage the community interest to improve things so I'm going to keep working on it and try to get all the pages formatted nicely to match the existing manual as best I can and into a state where people can make contributions.
I am already feeling that Markdown's limitations may become an issue. HTML on GitHub Pages would provide a lot more flexibility but would also make the barrier to entry higher for contributions.
@XORadmin: This is all your work, so please let me know if you would prefer that I pass ownership of the repo to you, or just remove it if it isn't what you'd like to see. I don't want this to end up making more work for you so please let me know if I've overstepped.

