GitHub & CSS Docs
"Jan 'oglop' Gazda" <[email protected]> Wed, 13 Nov 2019 09:44:36 +0100
| Newsgroups | gmane.text.docutils.user |
|---|---|
| Message-ID | <CAL1y04q6p7ecChcCfGu2GT0PUjUB6=rvL3UAFWm8UUXu9omjeA@mail.gmail.com> |
Hello everyone, I noticed there are more and more requests in moving the project over to GitHub, may I know why are you not considering moving over? Another question is about the documentation. I love RST especially due to it's style versatility and I think that docutils and Sphinx were the best inventions after python. But I suffer from dyslexia and current docs format makes it very difficult to read for me. It would much better to use Sphinx or some CSS which makes it easier to read. During my research I noticed several docutils forks around the internet (github) doing exactly the same thing I did (fork the docutils and process docs with sphinx) Here is an example of how does it look in my development flow with PyCharm. https://github.com/1oglop1/share/blob/master/README.rst Moving towards a better graphical style of docs would enhance the readability and prevented a repetitive work. Are there any obstacles preventing docutils from moving forward to this? Thank you. Jan Gazda