Pinax Moves from Sphinx to MkDocs
While Sphinx offers more features, MkDocs offers simplicity and familiar markup syntax. Even after years of writing docs in reStructuredText, it was still quite common to spend time looking up syntax.
This friction meant more times than not docs would just not get written. Time will tell but if we lower the friction to authoring documentation, the hope is that more documentation will get written and more will be maintained.
If you’d like to help us improve our documentation, please let us know in our Pinax Project Slack channel, make a pull request or file an issue here. Your help is greatly appreciated!