[Qgis-community-team] New QGIS Documentation Subscriber

Mon Jun 6 21:37:24 PDT 2016

Hi Angie,

I'm happy to have a look into your repo to the edits you did. Please
sent us the name of your github account then.

Also note that the Documentation is written in .rst files (see github)
and the building of the pdf goes via sphinx, latex to pdf.
So IF you want to make textual changes, you do that in the .rst files
If you want styling changes, you have to do that in the templates.

If not clear, maybe we can arrange a little skype meeting so I can show
you the building process?

And note, that becasse we are sprinting to a 2.14 release of the docs we
are most in need of reviewers and text writers.

Regards,

Richard

On 04-06-16 07:25, Angie Garcia wrote:
> 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
> _______________________________________________
> 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
> 