Just came accross that bit way above in this thread, from Feb '19
The Octatrack manual has been written, rewritten, and edited by multiple people over the years. The most merciful thing would be to put it out of its misery and the rewrite the whole thing… But that would be so much work that I’m afraid it will never happen.
In yesterday’s world, one poor guy would have had the tremendous and unwise task of doing it all by himself.
In today’s world, publishing the documentation on github and letting 1000+ people iterate over it in an open-source manner will yield way better results both in terms of quality and speed, in addition of making the whole process humanely manageable.
All you have to do is:
- Publish the whole OT documentation in an easily editable format (Markdown is common, for instance) to an official Elektron repository
- List the 10 most well-versed and trustworthy people from the Elektronauts forum and propose them to become moderator/maintainer/expert and supervise the repository (in addition to a few Elektron persons who remain owner of it)
- Give and enfroce guidelines such as:
- No-one ever writes directly to the main repository
- Documentation changes can be proposed by anyone, by creating small, fine-grained Pull Requests. That’s very important.
- Every Pull Request is reviewed, debated and fine-tuned by the maintainers you have appointed.
- Changes can be merged to the main repo only by these people, Pull Request after Pull Request, in an itterative way.
On the + side, you can fully automate the generation and upload of the pdf to Elektron servers every time the main repository is updated.
You can start with one product (like the OT) to get the hand of it all and once you are comfortable with it, extend to other products, one by one (by creating specific repository for each).
I, for sure, would make proposals and, judging by this thread, I’m sure I’m not the only one.
That’s quite easy to do actualy, all in all.
And if you don’t want to do it by yourself, you can find IT people to help you (like me).