GSoC/GCI Archive
Google Code-in 2011 MoinMoin Wiki

cooperation of sphinx and moin2

completed by: qxcv

mentors: Bastian Blank, Reimar Bauer, Thomas Waldmann, Prashant Kumar, Eugene Syromyatnikov

Abstract

How can sphinx and moin wiki cooperate? work flow, data flow, how to implement?

Details

Currently we write all documentation in our repository as rst files (see docs/ directory).

We also want to use the moin2 wiki to create wiki items for documentation which can be used by sphinx.

The task is about finding a way how this cooperation can be gracefully achieved.

You have to consider:

  • moin docs for users, for developers, for admins
  • how can we show documentation on the wiki?
  • how can we modify/extend documentation on the wiki?
  • how can we deal with documentation for different moin releases?
  • how can we show changes between releases?
  • differences between moin2 rst converter and sphinx capabilities.

You'll have to do a lot of thinking, researching and experimentation with rst and sphinx.

Deliverables: wiki page with a rather precise plan for work flow, data flow, how to implement

Skill Requirements

See tags.

Note: unless otherwise noted, tasks usually refer to moin2 (http://moinmo.in/MoinMoin2.0)!

You can discuss this issue in the MoinMoin wiki: http://moinmo.in/EasyToDo/cooperation%20sphinx%20and%20moin2