[Qgis-community-team] QGIS Documentation: increase the speed of documentation writing
David Forel
davidforel at yahoo.com
Wed Sep 19 17:45:45 PDT 2018
Hi Folks -
I found "qgis/QGIS-Documentation" on github. I presume this is the right repository, but I welcome your confirmation.
The "readme.rst" says nothing about 3.x and this disturbs me. In my knowledge of software releases, a move from a 2.x to a 3.x is significant, and I imagine is highly disruptive to the existing documentation. I imagine the documentation of 2.x that is in 3.x must have some gaping holes and is confusing where it assumes the user is in 2.x.
My point is not to complain; rather, I wonder whether instead of simply making better English in 2.x documentation that is in 3.x, someone might guide me to workflows that need to be revised or even created for 3.x.
Respectfully, David Forel
On Wednesday, September 19, 2018, 3:01:24 AM MDT, Alexandre Neto <senhor.neto at gmail.com> wrote:
Hi David,
I am preparing a video to show how to contribute to QGIS Documentation in an easy way. Unfortunatly I do not have an estimated release date for it. Please fell free to reach out if you have any questions that are blocking you.
Alexandre Neto
PS: Regarding the mailing list, make sure you are using the same email that you subscribed the mailing list. If you the original email forwarding to another inbox, that won't work. Also, e.g., for gmail my.email at gmail.com is the same as myemail at gmail.com, but for the mailing lists, they are totally different addresses.
Paolo Cavallini <cavallini at faunalia.it> escreveu no dia quarta, 19/09/2018 às 06:24:
Thanks David, you are most welcomed. Please start reviewing, directly through GitHub, and submit your pull requests. In case of doubts or problems, please refer to this list.
All the best.
Il 09/18/2018 09:04 PM, David Forel ha scritto:
Hi Folks -
I am a seasoned technical writer (American English), but only a beginner at QGIS (trying to climb the mountain).
I have read the instructions for submitting documentation to the project, but have not understood them at all; they are very complex. Setting that aside, I am open to reviewing anyone's English text. I even understand British English (!).
. . . . . . . . . . . . . .
David Forel
On Tuesday, September 18, 2018, 11:37:22 AM MDT, matteo <matteo.ghetta at gmail.com> wrote:
Hi Yves,
yes yes, +100 to spped up the merging process!
I also agree on the 3 steps that should make the way easier for all.
As Alexandre said: why not having some specific labels (sphinx fix) that
target some PR not blocker but that needs some special attention of some
sphinx expert.
For the typos: we have the amazing "fix me" link that also for skilled
writers is an immediate process to fix some small issues like typos.
Thanks for raising this
Cheers
Matteo
_______________________________________________
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..
Qgis-community-team at lists.osgeo.org
https://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
https://lists.osgeo.org/mailman/listinfo/qgis-community-team
--
Paolo Cavallini - www.faunalia.eu
QGIS.ORG Chair:
http://planet.qgis.org/planet/user/28/tag/qgis%20board/ _______________________________________________
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..
Qgis-community-team at lists.osgeo.org
https://lists.osgeo.org/mailman/listinfo/qgis-community-team
--
Alexandre Neto--------------------- at AlexNetoGeohttp://sigsemgrilhetas.wordpress.comhttp://gisunchained.wordpress.com
_______________________________________________
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..
Qgis-community-team at lists.osgeo.org
https://lists.osgeo.org/mailman/listinfo/qgis-community-team
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-community-team/attachments/20180920/7de77a90/attachment.html>
More information about the Qgis-community-team
mailing list