[GRASS-user] Call for documentation help

Dr. Manuel Seeger seeger at uni-trier.de
Tue Nov 13 08:43:27 EST 2007


Hello,
I'm now using GRASS for a while and try to introduce it to the students' 
education. So I think I could try to help with the enhancement of the 
documentation. But I am not a native english speaker. Extending, I could 
offer my support for german and spanish documentation.
Unfortunately, I do not feel able to coordinate this..;-)

Please let me know, where you could need my help!

Manuel

Michael Barton schrieb:
> The GRASS team needs your help. As you all are well aware, GRASS is 
> enormously sophisticated spatial analysis sophisticated. This also 
> makes it equally complicated and sometimes baffling for users, with 
> over 300 individual modules. GRASS has a top notch integrated and 
> contextual help system. BUT we need help in making the most of the 
> help system.
>
> As with all open source software, the development team is a group of 
> dedicated volunteers who work hard (in addition to their regular jobs) 
> to create the first rate software that you all use. They are also very 
> responsible in trying to document the program modules they code and 
> maintain.
>
> This is where your help is needed. In spite of best intentions and 
> efforts, development team members with coding skills need to put most 
> of their always limited time into writing and maintaining the code 
> that makes GRASS such a powerful and versatile software package. Many 
> of you in the GRASS community are expert users even if you do not have 
> expertise in programming. It is also clear from the traffic on this 
> list that you are regularly willing to share your expertise with 
> others by answering questions.
>
> Would some of you be willing to join the development team to help 
> manage and improve the GRASS documentation and help system? You don't 
> need to be proficient at programming, and because this is a team 
> effort, you don't even need to know all parts of GRASS. What is needed 
> is sufficient knowledge of some GRASS modules to help improve and 
> maintain their documentation pages, a little bit of html (the help 
> pages are in very basic html), and a desire to work cooperatively to 
> improve GRASS. Here is a partial list of roles that are needed.
>
> Individual module management:
> -Add or improve examples. Examples of how to use a module to get 
> different results is very helpful
> -Add or improve example graphic in modules. Screen shots are often 
> worth many words
> -Improve and enrich descriptions in English. In many cases, 
> documentation was written by valiant souls for whom English is a 2nd 
> (or 3rd or 4th) language. Native speakers are needed to enrich these 
> descriptions.
> -Add or improve non-English versions of the documentation. GRASS is 
> trying hard to be international and is used around the world. Much of 
> the operational language of the modules have been translated to other 
> languages (though a lot more help is needed in this too). Help and doc 
> pages in other languages would make GRASS much more usable globally.
>
> Overall:
> -Documentation management. Someone or ones to mangage a team of 
> documentation helpers, ID holes and weak spots in the documentation, 
> coordinate with the coding team, and think about documentation standards.
>
> If you are interested and willing to contribute a small part of your 
> time to help others use GRASS, please respond to the GRASS Developer 
> list <grass-dev at grass.itc.it> and copy the GRASS project team leader, 
> Markus Neteler <neteler [at] fbk.eu>
>
> Michael
>


-- 

_______________________________________________________________________
Dr. Manuel Seeger
Wiss. Assistent 			Scientific Assistant
Physische Geographie 			Dpt. of Physical Geography
FB VI - Geographie/Geowissenschaften 	Geography/Geosciences
Universität Trier			University of Trier
D - 54286 Trier
Tel.:	+49-651-201 4557
Fax:	+49-651-201 3976
Web:	http://www-neu.uni-trier.de/index.php?id=9607




More information about the grass-user mailing list