We know this is a huge task, there's a lot of documentation, and there's a lot of game engine that needs to be documented, but when we are done we should have the largest centrally located documentation set since the original TDN wiki back in the distant past.
As mentioned its a huge task, so any help anybody can provide will be invaluable. If you wish to contribute to the documentation there are a multitude of ways you can do so
- Forking the repo and unstable branch https://github.com/Torque3D/OnlineDocs and editing it directly and then submitting a PR.
- Writing or rewriting any of the pages and just posting the text here in the forums
- Linking to any tutorials you think should be added eg Steves multi-part tutorials on FPS and turn-based games
- A really important and valuable thing would be just reading the documentation take a section and make a mini report on what is incorrect or needs updating.
- Make suggestions of what might be missing and what we should add (we have a big list already but there's always a chance we missed something)
readthedocs as a system has all kinds of useful features, it allows us to maintain multiple sets of documentation, so when 3.10 documentation is completed, and we branch off to update for the 4.0 documentation the old docs will still be there for people who still use and maintain a game using 3.10.
Another neat feature is the ability for readthedocs to create a fully indexed and hyperlinked PDF book https://media.readthedocs.org/pdf/torqu ... rque3d.pdf this particular version is 1000 pages and bit of a long read if you want to read cover to cover, but if you scroll to the end, you will find a wonderfully detailed index with links back to the tutorial pages etc.