[Numpy-discussion] MoinMoin <-> docstrings gateway

Gael Varoquaux gael.varoquaux at normalesup.org
Mon May 5 01:48:00 EDT 2008


On Mon, May 05, 2008 at 03:17:20AM +0300, Pauli Virtanen wrote:
> Some time ago there was discussion about MoinMoin <-> docstrings
> gateway. Did it produce some results?

My girlfriend, Emmanuelle, (Cced, I am not sure she follows this mailing
list) has been working on this, with some progress.

> Anyway, I threw a bit of code together. There's something between a
> proof-of-concept and final product running now on my desktop machine.
> You can play with it here:

> 	http://pvx.homeip.net/pTSc0V/TestWiki

Sweet. Some comments: 

* A lot of the docstrings are not valid rst. This is not your fault, but
  we will had to fix this in the long run.

* I would prefer if the main page was broken up into one per function. I
  know this is the way it is in the actual wiki layout, but I think it
  would be better if it was presented this way to the user. Anyway, this
  is debatable.

* Emmanuelle has functions to read from the wiki and write to it from a
  remote client. I am not sure how well they work, but it would be nice
  not to require a login and rights on the server to generate patches.

> Is there interest to move forward with this?

There is. With Emmanuelle and Stefan van der Waalt, who has also been
following the project, we were considering using a webapp running with
turbogears to move forward. They would know better what the status is.

Congratulations for that. Let us hope you can join forces with the other
team working on that to bring this project to its success.

Cheers,

Gaël



More information about the NumPy-Discussion mailing list