|
From: | Dmitry Gutov |
Subject: | Re: Trunk still not open |
Date: | Sun, 16 Mar 2014 02:39:54 +0200 |
User-agent: | Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.3.0 |
On 15.03.2014 10:22, Eli Zaretskii wrote:
Texinfo is almost plain text, the markup you need to learn is quite minimal, and fairly similar semantically to HTML. The markup is also quite a mechanical part of writing the docs, and you will quickly learn to do it correctly given the comments for your first submissions.
It can be easy to change some small part of an existing page. Writing a new one would be a bit harder. I think it would cut down on casual contributions either way.
Take a look at gdb-patches mailing list, where we have people writing docs for every patch, and see for yourself how this works. There are a few of them there for whom writing English is much more difficult than writing C or Python, and yet they still do this.
As a program written in C, GDB doesn't have the same concept of docstrings visible to the user. So the manual is necessary, and if the author of a patch doesn't do it, AFAICT in many cases that won't be practical to do post-factum.
At least they don't have to duplicate the text.
[Prev in Thread] | Current Thread | [Next in Thread] |