[SciPy-dev] Docstring editing request on SciPy Doc Wiki

Stéfan van der Walt stefan at sun.ac.za
Mon May 19 13:19:27 EDT 2008


2008/5/19 Robert Kern <robert.kern at gmail.com>:
> On Mon, May 19, 2008 at 10:50 AM, Stéfan van der Walt <stefan at sun.ac.za> wrote:
>> 2008/5/19 Robert Kern <robert.kern at gmail.com>:
>>> On Mon, May 19, 2008 at 3:58 AM, Stéfan van der Walt <stefan at sun.ac.za> wrote:
>>>
>>>> For developers: please don't change docstrings directly in the source
>>>> tree, it makes merging difficult.  If you urgently need a change to go
>>>> in, make it on the wiki and let me know.
>>>
>>> Ooh. Not good. It's not time-critical, but this needs to be fixed.
>>
>> It's not a train smash -- but it causes some patches to be rejected.
>> I don't think this is something that can be "fixed"; it's inherently a
>> merge problem.
>
> Okay, but this has to be a problem that the wiki->docstring system (or
> its human operator) needs to deal with, not developers. It's just not
> acceptable to have parts of the source that we can't edit directly.

You may edit the code directly, if you so wish, but the changes won't
immediately be visible to other editors working via the wiki.  So
rather than a technological limitation, I see it as a matter of
courtesy.  But don't worry about it, I'll merge the docstrings as
necessary.

Regards
Stéfan



More information about the SciPy-Dev mailing list