python-fastimport: please provide overview documentation

[Jonathan Nieder]

Hi,

It can be hard to get started with a new module without some
documentation or examples to indicate how it is meant to be used.
Maybe some docstrings could help? Patch attached[1]. (Background at [2].)

Thoughts?
Jonathan

 affects python-fastimport

[1]
Jelmer Vernooij wrote:

> At the moment the best way to submit changes is to submit merge
> proposals against the Bazaar branch.

Hopefully lesser ways also work. ;-) (I have an irrational dislike
for complicated contribution procedures.) Applies with "bzr patch -p1".

[2]
> There's an upstream project on Launchpad that's the preferred address at
> the moment: https://launchpad.net/python-fastimport

Filing. http://bugs.debian.611601 has the original report.

[Jelmer Vernooij (jelmer)]

Hi again :)

On Tue, 2011-02-08 at 21:37 +0000, Jonathan Nieder wrote:
> It can be hard to get started with a new module without some
> documentation or examples to indicate how it is meant to be used.
> Maybe some docstrings could help? Patch attached[1]. (Background at [2].)
Thanks, I'll have a look at this next time I work on python-fastimport.

> > At the moment the best way to submit changes is to submit merge
> > proposals against the Bazaar branch.
>
> Hopefully lesser ways also work. ;-) (I have an irrational dislike
> for complicated contribution procedures.) Applies with "bzr patch -p1".
A merge proposal makes it easier to track the progress of patches using
Launchpad, but this works too.

 status triaged
 importance medium

Cheers,

Jelmer

[Jelmer Vernooij (jelmer)]

Merged now, thanks!