On Tuesday, May 20, 2014, Merlijn van Deen <valhallasw(a)arctus.nl> wrote:
Recently, I've been thinking a lot about this, so this was a good reason
to write those thoughts down; I created a wiki page for that:
https://www.mediawiki.org/wiki/Help:Pywikibot/Documentation_RFC
Basically, I'm not a big fan of sphinx because of the lack of
accessibility (and I *loathe* restructuredtext), and we lose e.g.
translations when we switch, so I would prefer something centered around
mw.org. However, I *do* agree it's a huge issue that code and docs are
never in sync. Anyway, see the not-yet-a-real-RFC for my thoughts.
The Engineering Community team and others at the WMF are planning to work
in this project to sort out and showcase the MediaWiki API + neighbors.
Your feedback is welcome there.
--
Quim Gil
Engineering Community Manager @ Wikimedia Foundation