While the plain text documents are really close, it would be nice to see a markdown formatted version of the documentation, even replacing the .txt version with a markdown set could be benificial. Markdown can easily be converted to plain text if necessary, and to html for viewing. I'm not sure if there is enough demand for this to make it worth it or not, but I would see it as an asset but a bigger undertaking than I could do alone. plain text lacks a lot of the formatting needed to differentiate between code comments and code snipits when rendering it directly as markdown with tools like md-fileserver. The plain text works great for custom search tools when using a local file store for the documentation and markdown wouldn't hinder that. -- ------------------------------------------------------------------------ David VanderWyst Owner, Thriftech services <https://thriftechs.com/> dave.cs@thriftechs.com
Python documentation are written in Restructured Text and built with Sphinx. It is not plain text. We won't be switching from ReST to Markdown. If what you're after is a downloadable copy of the docs in ReST, it is part of CPython source code. You can clone/download it from GitHub: https://github.com/python/cpython On Dec 13, 2017 5:44 AM, "David VanderWyst" <dave.cs@thriftechs.com> wrote: While the plain text documents are really close, it would be nice to see a markdown formatted version of the documentation, even replacing the .txt version with a markdown set could be benificial. Markdown can easily be converted to plain text if necessary, and to html for viewing. I'm not sure if there is enough demand for this to make it worth it or not, but I would see it as an asset but a bigger undertaking than I could do alone. plain text lacks a lot of the formatting needed to differentiate between code comments and code snipits when rendering it directly as markdown with tools like md-fileserver. The plain text works great for custom search tools when using a local file store for the documentation and markdown wouldn't hinder that. -- ------------------------------ David VanderWyst Owner, Thriftech services <https://thriftechs.com/> dave.cs@thriftechs.com _______________________________________________ docs mailing list docs@python.org https://mail.python.org/mailman/listinfo/docs
participants (2)
-
David VanderWyst -
Mariatta Wijaya