|
From: | Dmitry Gutov |
Subject: | Re: Next release from master |
Date: | Wed, 10 Feb 2016 06:13:36 +0200 |
User-agent: | Mozilla/5.0 (X11; Linux x86_64; rv:44.0) Gecko/20100101 Thunderbird/44.0 |
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.
[Prev in Thread] | Current Thread | [Next in Thread] |