Summary
OK! That was a lot of information and barely scratched the surface of all the options available. Hopefully, you can see that the wide world of documentation tooling, while not quite as wide as developer tooling, offers a lot of options to suit almost all tastes and requirements.
This chapter covered the essential tools you need for using the docs as code methodology while also looking closely at two of the other popular methodologies many documentarians use.
If you want to find more options, take a look at this awesome list for documentation tooling: https://testthedocs.github.io/awesome-docs/.
Those essential tools for docs as code are as follows:
- A text editor to write in
- A markup language to use
- A way of collaborating with others
- A way to render the documentation you write
- Methods for assessing how useful readers find the documentation
I also covered important topics related to these tools, such as metadata, newer markup language options...
