[documentation] Improving help pages in D7

[adept digital evolution]

On 11-13-2009 3:11 PM, Lee Hunter wrote:
> Is there any chance that the content development and editing could be 
> done via pages on drupal.org <http://drupal.org> and then rolled into 
> patches?
>
> There are a lot of people (ok, maybe just me) who could help with 
> content but are not down with that whole patch thing. Also it would 
> make it a lot easier to compare pages and make sure everything's 
> consistent before committing the patches.

I have to agree. There should be an easier way to participate for 
non-developers who, like myself, know nothing of CVS systems or patches 
or php, and who do not have time or inclination to learn that end of 
things, but who (also like myself) might be quite good at helping to 
author and organize good help documentation.

I've pretty much given up on helping with docs because I click links 
from this discussion list to look at an issue, and then have absolutely 
no idea what to do. It looks like I'd have to know php, to know how to 
check out items from some repository somewhere (where?), how to write 
something called a "patch", how to test it, and so on. This is just not 
my profession. The whole approach pretty much freezes just regular old 
consultants and writers from your process.

I had done much work on  he D7 install guide (the online version) and 
therefore offered to also review the install.txt document that gets 
included with the downloaded installer , but for some reason this is 
much more complicated than just editing a text document. I didn't know 
where to get it or what the heck to do with it. I used up my time trying 
to figure all that out without ever even finding it.

I will continue to edit any d.o doc pages that I might have priv's to 
edit. But I hope some day editing help text is as easy as editing 
anything on d.o

kazar