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