Re: Next release from master

[Dmitry Gutov]

On 02/10/2016 06:02 AM, Óscar Fuentes wrote:

> This response would be very apropos in case Alexis contributed some
> feature without documentation.

My sole (admittedly passive-aggressive) point is, if someone's not 
helping with code or documentation, they should get no vote on what the 
process should be.

> IMO it is very reasonable to require documenting the contributed
> changes. Without that, code reviews and testing are much harder.

Not if the feature has appropriate docstrings and header commentary.

As far as I'm concerned, the manual is a separate universe which 
requires additional knowledge to contribute to.

> If the
> documentation is not correct English, as long as it is understandable
> with some effort, fixing that is easier (*) than reading the code,
> understanding its purpose and writing documentation while hoping that
> you are describing what the contributor actually intended to implement.

Hopefully, one doesn't have to read the code to translate the docstrings 
into the manual (AFAICT, Eli tried not to). The person who does the 
documentation also can ask questions.