Last modified: 2014-07-25 12:00:49 UTC

Wikimedia Bugzilla is closed!

Wikimedia migrated from Bugzilla to Phabricator. Bug reports are handled in Wikimedia Phabricator.
This static website is read-only and for historical purposes. It is not possible to log in and except for displaying bug reports and their history, links might be broken. See T66846, the corresponding Phabricator task for complete and up-to-date bug report information.
Bug 64846 - Provide sensible documentation platform
Provide sensible documentation platform
Status: NEW
Product: Pywikibot
Classification: Unclassified
documentation (Other open bugs)
core-(2.0)
All All
: High normal
: ---
Assigned To: Pywikipedia bugs
:
Depends on:
Blocks: pwbdoc
  Show dependency treegraph
 
Reported: 2014-05-04 19:55 UTC by Merlijn van Deen (test)
Modified: 2014-07-25 12:00 UTC (History)
4 users (show)

See Also:
Web browser: ---
Mobile Platform: ---
Assignee Huggle Beta Tester: ---


Attachments

Description Merlijn van Deen (test) 2014-05-04 19:55:47 UTC
The typical documentation platform for Python projects is Sphinx (combined with readthedocs, typically). However, we have Mediawiki.org, which has the advantage of having translated pages.

It would be nice to have the English docs in the git repository, as that would make keeping them up-to-date *much* easier. In addition, that would make it much easier to auto-generate parts of the documentation (e.g. script parameters and API docs).

It would be nice if we could find a way to have the best of both worlds, e.g. by having something that parses docs to Translate-enabled wikitext.

Note You need to log in before you can comment on or make changes to this bug.


Navigation
Links