4 ms·
Offtopic question, what documentation tool is used for this? I've seen it a lot of times but I'm not sure how to search for it. Thanks!
by Trufa 10y ago
Offtopic question, what documentation tool is used for this? I've seen it a lot of times but I'm not sure how to search for it. Thanks!
- deleted 10y ago[deleted]
- deleted 10y ago[deleted]
- nowbacktowork 10y agoSphinx, it's linked to in the footer.
- Trufa 10y agoThanks, didn't see it!
- geofft 10y agoIt's made with Sphinx, a tool commonly used for Python documentation. But it can render reStructuredText that isn't associated with Python just as well, so it's popular for other projects. http://sphinx-doc.org/ http://sphinx-doc.org/ (There's a link to Sphinx at the bottom of the page) It looks like this is just generated from Documentation/index.rst and linked pages in the kernel source tree, which seems to have been created less than a year ago: https://github.com/torvalds/linux/commits/master/Documentation/index.rst https://github.com/torvalds/linux/commits/master/Documentati...
- mook 10y agoFor background on the docs in the kernel source tree, LWN (as is often the case) had a good article about it: https://lwn.net/Articles/692704/ https://lwn.net/Articles/692704/ There's also a copy on kernel. org, not sure why Intel's copy is being linked here. It's probably the same text, so any copy should be equally good, it just feels less canonical to me. Probably silliness on my part for even thinking of it.
- geofft 10y agoOh, hey, there's a rendered copy at https://www.kernel.org/doc/html/latest/process/coding-style.html https://www.kernel.org/doc/html/latest/process/coding-style.... , neat! (I knew about the unrendered one at /doc/Documentation)
- cyphar 10y agoAt the bottom of the page: > Built with Sphinx using a theme provided by Read the Docs. John Corbert has done quite a bit recently within Documentation to make it more structured and has (from my understanding) massively revamped the documentation compilation.