[Qgis-community-team] QGIS Documentation: increase the speed of documentation writing

[Yves Jacolin]

Hello David,


Le 20/09/2018 à 02:45, David Forel a écrit :
> Hi Folks -
>
> I found "qgis/QGIS-Documentation" on github.  I presume this is the
> right repository, but I welcome your confirmation.
I confirm!
>
> 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.
The README file is not up to date :) We should add 3.x releases,
probably remove 2.x links and update the contacts list.
>
> 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.
PR welcome :) Do you have any idea how to do this? Read this
https://docs.qgis.org/2.18/en/docs/documentation_guidelines/first_contribution.html#using-github-web-interface
if there are any problem, we can help!

Many thanks!

Y.
>
> 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 <mailto:my.email at gmail.com> is the same as
> myemail at gmail.com <mailto:myemail at gmail.com>, but for the mailing
> lists, they are totally different addresses.
>
> Paolo Cavallini <cavallini at faunalia.it <mailto: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> <mailto: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
>>     <mailto: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
>>     <mailto:Qgis-community-team at lists.osgeo.org>
>>     https://lists.osgeo.org/mailman/listinfo/qgis-community-team
>
>     -- 
>     Paolo Cavallini - www.faunalia.eu <http://www.faunalia.eu>
>     QGIS.ORG <http://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
>     <mailto:Qgis-community-team at lists.osgeo.org>
>     https://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
> <mailto: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

-- 
http://yjacolin.gloobe.org

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-community-team/attachments/20180920/c1fc0259/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 473 bytes
Desc: OpenPGP digital signature
URL: <http://lists.osgeo.org/pipermail/qgis-community-team/attachments/20180920/c1fc0259/attachment-0001.sig>