[sugar] apis at 4%

[Marco Pesenti Gritti]

On Mon, Sep 22, 2008 at 12:24 AM, David Farning <dfarning at sugarlabs.org> wrote:
> On Sun, 2008-09-21 at 23:35 +0200, Marco Pesenti Gritti wrote:
>> On Sun, Sep 21, 2008 at 7:00 PM, David Farning <dfarning at sugarlabs.org> wrote:
>> >
>> > The patches are flowing into the git tree correctly.  If you find bugs
>> > or anything that looks kludge in the system, please let us know.  This
>> > is the first time pydocweb has been used 'in the wild.'
>>
>> It's great to see progress on this!
>>
>> A couple of things:
>>
>> * Is it ok to commit changes to the documentation in git?
> Yes
>
>> Will pydocweb pick them up?
> Yes, pydocweb uses merge from GNUs RCS to handle changes between the
> docstrings in the pydocweb database and the source code.  Whatever merge
> can not figure out, is flagged for editor attention.

I will commit it, let me know if it causes any problem.

>>  There is a long line in alert.py which is causing a pylint warning.
> Could you turn off the documentation related pylint warnings for now?  I
> am getting hundreds of warnings from pydocweb about errors in our
> docstrings:(  Over the next few weeks we can work through the pydocweb
> warnings, then turn the pylint warning back on.

The warning I have is just a line too long, so not documentation
specific and it's the only one I'm getting. I'm not sure which errors
you are referring to here?

>> * I think it would be better to keep the top block of documentation
>> under the license.
>
> Which file was mangled? I can file a bug about the location of package
> level docstrings.

alert.py

Marco