[Qgis-community-team] We need help updating the qgis user guide for version 2.2

Fri Apr 4 10:35:13 PDT 2014

Hi Eduardo,

your procedure is perfect! The most important part is to find the right
place where to add the new feature and then write about it. And if you see
other sections, where it might make sense to add a reference, even better.

Thanks a lot!
Otto

Am Fri, 4 Apr 2014 20:26:13 +0300
schrieb Eduardo Gonzalez <eg at gismood.com>:

> Hi Otto,
> 
> I checked the Features still needing work to be done for the user manual. I
> decided I first take an easy one and see what I should do with it. I
> selected the "Fill ring digitizing tool" (marked already with my name in
> the wiki). Then I started thinking on what is it that I am supposed to
> do... (besides getting my github fork updated) This is my conclusion:
> 1- I check what the feature is about
> 2- I look for any possible place in the user guide where that feature
> should be mentioned (like wherever the advanced digitizing tools are
> described) or might be applied (wherever an advanced digitizing example
> might be shown). For this I just did a text search (e.g. digitizing,
> ring...) in the user manual folder of my git fork
> 3- That way I got a number of files where the Fill ring tool might need to
> be added
> 4- I go through the file (both the .rst and the corresponding webpage) and
> decided if some update is needed
> 5- Next steps would be actually writing somthing about the tool wherever it
> corresponds and updating icons/images as needed
> 6- Finally push changes to main repo
> 
> Is this the correct way to proceed? Am I missing something important?
> 
> Regards,
> 
> Eduardo
> 
> 
> 
> On Sat, Mar 29, 2014 at 10:35 AM, Otto Dassau <dassau at gbd-consult.de>
> wrote:
> 
> > Dear Eduardo,
> >
> > your help would be very much appreciated. As you might have read below,
> > we work with a list in the wiki to update QGIS 2.2:
> >
> > http://hub.qgis.org/wiki/quantum-gis/ManualTasks
> >
> > You can just log in and select a feature you would like to work on and
> > write your name right to it. If you need an account to log into the wiki,
> > please subscribe here:
> >
> > https://www2.osgeo.org/cgi-bin/ldap_create_user.py
> >
> > For working on the repositoty. The best would be, if you create a fork
> > from the current documentation master into your github home:
> >
> > https://github.com/qgis/QGIS-Documentation
> >
> > work on that fork and send pull requests with the chapters you worked on.
> >
> > The local build process to test what you have done is described here
> > under "Build Tools":
> >
> > https://github.com/qgis/QGIS-Documentation/blob/master/readme.rst
> >
> > I hope this helps you to get started. Otherwise just write to the list
> > and we will help.
> >
> > Regards
> > Otto
> >
> > Am Sat, 29 Mar 2014 09:25:37 +0200
> > schrieb Eduardo Gonzalez <eg at gismood.com>:
> >
> > > Hello Otto,
> > >
> > > I can help in the udate of the user guide to 2.2, if sitll needed I
> > already
> > > have the git repository in my computer and downloaded the 2.2.
> > >
> > > Let me know what follows!
> > >
> > >
> > > Eduardo
> > >
> > >
> > > On Fri, Jan 24, 2014 at 3:42 PM, Otto Dassau <dassau at gbd-consult.de>
> > wrote:
> > >
> > > > Hi,
> > > >
> > > > thanks again to all those who volunteered to help with the QGIS
> > > > manual update. And maybe there are some more people to help, since
> > > > there is as always a lot of new features to document :)
> > > >
> > > > I added a list of new features to the wiki:
> > > >
> > http://hub.qgis.org/wiki/quantum-gis/ManualTasks#Updates-QGIS-20-User-Guide
> > > >
> > > > The next steps would be:
> > > >
> > > > a) Install a QGIS 2.1 package from master (available for windows,
> > ubuntu
> > > > and
> > > >    opensuse I think) or compile from source. If you don't know how to
> > do
> > > >    that, we can help.
> > > > b) Go through the wiki and add you name right to the features that
> > > > you want to work on.
> > > > c) checkout the master branch of the QGIS documentation and update
> > > > the rst files following the documentation guidelines:
> > > >
> > > >
> > https://github.com/qgis/QGIS-Documentation/blob/master/source/docs/documentation_guidelines/README.rst
> > > >
> > > > Lene and Luca, I don't know if you are familiar with git and
> > > > installing/compiling QGIS from master. Please tell us, where you need
> > > > help.
> > > >
> > > > Regards
> > > > Otto
> > > >
> > > > Am Mon, 20 Jan 2014 11:24:09 +0100
> > > > schrieb Otto Dassau <dassau at gbd-consult.de>:
> > > >
> > > > > Am Mon, 13 Jan 2014 10:19:57 -0800 (PST)
> > > > > schrieb Luca Casagrande <luca.casagrande at gmail.com>:
> > > > >
> > > > > > Otto Dassau-3 wrote
> > > > > > > Dear Community,
> > > > > > >
> > > > > > > at 2014-01-24 (11 days away), we'll go into feature freeze for
> > the
> > > > next
> > > > > > > qgis
> > > > > > > version 2.2, which will be released at 2014-02-21 (39 days
> > > > > > > away).
> > > > > > >
> > > > > > > To have an updated user manual at that time we need to build a
> > > > > > > documentation
> > > > > > > team with people who take care about certain tasks and chapters
> > > > > > > after the feature freeze. Please send a note to the
> > community-team
> > > > > > > list, if you are able to help, so we have a nice documentation
> > > > > > > again.
> > > > > > >
> > > > > > > We will organize the work in the wiki...
> > > > > > >
> > > > > > >
> > > >
> > http://hub.qgis.org/wiki/quantum-gis/ManualTasks#Updates-QGIS-22-User-Guide
> > > > > > >
> > > > > > > Regards
> > > > > > > Otto
> > > > > >
> > > > > > Hello Otto,
> > > > > > I'm happy to help out for updating the manual.
> > > > > >
> > > > > > Ciao
> > > > > > L.
> > > > >
> > > > > thanks a lot Luca,
> > > > >
> > > > > I will write more instructions to this list after feature freeze
> > > > > (2014-01-24).
> > > > >
> > > > > Regards
> > > > > Otto
> > > >
> > > > _______________________________________________
> > > > Qgis-community-team mailing list for organizing community resources
> > such
> > > > as documentation, translation etc..
> > > > Qgis-community-team at lists.osgeo.org
> > > > http://lists.osgeo.org/mailman/listinfo/qgis-community-team
> > > >
> >
> >
> > --
> > Geoinformatikbüro Dassau - http://www.gbd-consult.de
> > FOSSGIS consulting , training , support and analysis
> > Ackerstrasse 144c ,  D - 40233 Düsseldorf  , Germany
> > Tel: +49-(0)211-47468178 , Mobil: +49-(0)171-4687540
> >
> > --
> > Community Advisor - QGIS Project Steering Committee
> >

-- 
Geoinformatikbüro Dassau - http://www.gbd-consult.de
FOSSGIS consulting , training , support and analysis
Ackerstrasse 144c ,  D - 40233 Düsseldorf  , Germany
Tel: +49-(0)211-47468178 , Mobil: +49-(0)171-4687540

--
Community Advisor - QGIS Project Steering Committee