[Qgis-community-team] QGIS Documentation: increase the speed of documentation writing
Yves Jacolin
yjacolin at free.fr
Wed Sep 19 23:36:32 PDT 2018
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>
More information about the Qgis-community-team
mailing list