On Tue, May 20, 2014 at 1:29 AM, Pyfisch <pyfisch@googlemail.com> wrote:
Great that someone takes care of the coding guidelines. I have no problem with all of the naming conventions and tests, but I would like to change the documentation part.

Sphinx can generate really good docs from the source code and you only need to change source code, and then we could generate and host the docs on the labs server. If we require to update mediawiki.org, we wont ever reach sync between code and documentation. I propose to remove the documentation on mediawiki and only use sphinx for docs, but everywhere.

Some people (mainly Merlijn) are working on it:
https://gerrit.wikimedia.org/r/133939

It's not quite easy because Sphnix can't support wikitext 
Regards


_______________________________________________
Pywikipedia-l mailing list
Pywikipedia-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/pywikipedia-l
Another thing is I forgot to tell people not to add one-time-used codes or codes can't be widely used to pywikibot. Just make a repo in pywikibot/bots/yourepo using this and move your codes there (instead putting them into github or other code repos including pywikibot) if someone make a documentation for it I would really appreciate that
Best


--
Amir