[Qgis-community-team] New QGIS Documentation Subscriber

Fri Jun 3 22:25:33 PDT 2016

To move forward with editing documentation, I have created a sample of how the User Guide 2.14 could be modified.  Keep in mind this is only one idea, all input is welcomed.

All changes were indicated with red font, I made changes up to end of chapter 1.  Need to upload pdf to repository.  Can someone provide best way to do this?  I have created my GitHub account and fork (created copy of repository), installed the Git, but not created the local repository.

I worked on document aesthetics, content, consistency and followed along using QGIS software.  However, if a re-design change is made to the document, it would be a good idea to update other manuals.

The idea will be to edit one section/chapter at a time then upload it to the repository.

Best Regards,
Angie

________________________________________
From: Qgis-community-team <qgis-community-team-bounces at lists.osgeo.org> on behalf of Yves Jacolin <yjacolin at free.fr>
Sent: Thursday, June 2, 2016 5:17:40 AM
To: qgis-community-team at lists.osgeo.org
Subject: Re: [Qgis-community-team] New QGIS Documentation Subscriber

Hello,

A good start for an english native speaker could be:
* make review of Pull request
* proof read the doc to see english error, etc. and create issue with the
correct sentence.

That would be a really huge enhancement, but also a hard work.

Y.

On Thursday, June 02, 2016 1:20:25 DelazJ wrote:
> Hi,
>
> Welcome Angie and thanks for offering your help!
>
> As already pointed out by Richard you'll find few recommendations to follow
> when contributing to QGIS Documentation writing at
> http://docs.qgis.org/testing/en/docs/documentation_guidelines/
> But prior to this, In order to contribute, you'll need as stated at
> http://qgis.org/en/site/getinvolved/document.html#becoming-a-documenter  to:
> - create a GitHub account
> - and fork (copy) the doc repo
>
> Once done, feel free to pick any issue in the list and write about. You can
> also go through the doc being written (docs.qgis.org/testing/en/docs) and
> fix potential typo errors, "bad english" (most of us are not native
> speaker) or review/comment contributions of others (
> https://github.com/qgis/QGIS-Documentation/pulls).
>
> Once again, welcome to you and if something is unclear, just ask. Someone
> will try to explain to you.
>
> Regards,
> Harrissou
>
> 2016-06-02 0:17 GMT+02:00 Alexandre Neto <senhor.neto at gmail.com>:
> > Angie,
> >
> > Welcome to the team. Thanks you for helping us with the docs.
> >
> > I normally do the screenshots, so anything you need, let me know. Are you
> > on github already?
> >
> > Alexandre Beto
> >
> > A qua, 1/06/2016, 22:50, Angie Garcia <amg832 at outlook.com> escreveu:
> >> Richard,
> >>
> >> English is my primary language.  Read QGIS is natively developed in
> >> English, if you need assistance in looking at text before pulling it into
> >> the docs, glad to help just need to know what needs to be done.
> >>
> >> Best Regards,
> >> Angie
> >>
> >>
> >> ________________________________________
> >> From: Richard Duivenvoorde <rdmailings at duif.net>
> >> Sent: Tuesday, May 31, 2016 11:53:43 PM
> >> To: Angie Garcia
> >> Cc: dassau at gbd-consult.de; Junior Delaz; Yves Jacolin; qgis-community
> >> Subject: Re: New QGIS Documentation Subscriber
> >>
> >> On 31-05-16 22:33, Angie Garcia wrote:
> >> > Hi Richard,
> >> >
> >> > I have recently subscribed and would like to participate with updating
> >> > User Guide and assist in suggestions to aid in the documentation work
> >> > flow.  In going through all online/materials, it mentioned that one
> >> > should contact team lead in specific area of interest to get some
> >> > assistance in the process.  I have cc Otto as he was the person I sent
> >> > email to, however, have not heard from him and thought you might be
> >> > able
> >> > to help me or point me in the right direction to move forward.
> >> >
> >> > Is there a new welcoming documentation packet which helps one get
> >> > setup,
> >> > have a mailing list of individuals to contact, talks a little about the
> >> > various emails and limitations, etc...
> >>
> >> Hi Angie,
> >>
> >> For what I know this:
> >>
> >> http://docs.qgis.org/testing/en/docs/documentation_guidelines/
> >>
> >> are the guidelines. In the README at:
> >>
> >> https://github.com/qgis/QGIS-Documentation
> >>
> >> is more information about how to actually BUILD the docs.
> >>
> >> Note that it is actually not persee nessecary to build it yourself. If
> >> you follow the 'fix me' link in the footer of the pages on current
> >> 'testing' (==2.14 to be) version:
> >>
> >> http://docs.qgis.org/testing/en/docs/user_manual/index.html
> >>
> >> you can write/fix smaller parts of the docs in Github.
> >>
> >> I added Harrisou and Yves in cc, they have been mostly active I think
> >> recently, and maybe can give you a hand too.
> >> I will also sent this email to the community list where most document
> >> writers hang out.
> >>
> >> Here:
> >>
> >> https://github.com/qgis/QGIS-Documentation/issues
> >> all issues labeld QGIS 2.14
> >> https://github.com/qgis/QGIS-Documentation/milestones/QGIS%202.14
> >> should be taken up in short notice.
> >> Not sure if you are native speaker, but we also look for native speakers
> >> to have a look at texts of others before pulling into the docs.
> >>
> >> Pick an issue, try something, ask... just DO it ;-)
> >>
> >> Regards,
> >>
> >> Richard Duivenvoorde
> >>
> >> ps reaching me in private is best done via richard at qgis.org... Using the
> >> rdmailings you end up in the big pile of mailinglists I have :-)
> >> BUT I prefer communicating through mailing lists as more people learn
> >> from this.
> >>
> >> _______________________________________________
> >> 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
> >
> > --
> > Alexandre Neto
> > ---------------------
> > @AlexNetoGeo
> > http://sigsemgrilhetas.wordpress.com
> > http://gisunchained.wordpress.com
> >
> > _______________________________________________
> > 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

_______________________________________________
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