<div dir="ltr"><div dir="ltr"><div dir="ltr">Hi All,<div><br></div><div>Thanks for the feedback Harrissou.</div><div><br></div><div>I agree that the current step by step contribution guide on the QGIS website is great, I don't think I would have been able to complete my first contribution without it. The notes that I made were just for me so that I didn't forget the process, but I did share them with the Australian user group. The reason why I created the document was that the GitHub process for a non-coder like me was new and I had to record the steps as they weren't obvious in the current guide. So to your point about being "at the wrong place to see the subtle differences in the two docs (what we propose now is a bit like what you wrote, minus GH screenshots)" - I would agree with you that the differences is only the GitHub screenshots (and my own words for personal familiarity). I think if the process uses GitHub and the document is intended for first timers, then it may benefit from some screenshots and assuming no GitHub experience.</div><div><br></div><div>As for your label suggestion, yes please! Anything that makes it easier to find the correct page to edit is a huge help the first time. I admit you do get familiar with the structure the more you use it, but on my first effort I spent a fair while looking for the page.</div><div><br></div><div>And i'd like to add that the first ever contribution was intimidating but you and others I encountered in the QGIS docs were a great help and very welcoming. For that thank you very much!</div><div><br></div><div>Thanks</div><div><br></div><div>Andrew</div><div><br></div><div><br></div></div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, May 4, 2019 at 5:36 PM DelazJ <<a href="mailto:delazj@gmail.com">delazj@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div dir="ltr"><div>Hi all,</div><div><br></div><div>First of all Congratulations to Cameron and all those who helped OSGeo submission. Thanks.</div><div><br></div><div>Andrew, I went through your interesting notes (great idea to have written your experience). I think our projects suffer from the lack of feedbacks from newbies. Things that became obvious to advanced users can be a barrier for beginners and such writings help to fill the gap. This was the idea behind the step by step chapter and your notes are the kind of initiatives that may help to improve its quality. I'm unfortunately at the wrong place to see the subtle differences in the two docs (what we propose now is a bit like what you wrote, minus GH screenshots). Maybe another "newbie" (but not only) can give a try and find the gap so that we pick from your experiences...?</div><div><br></div><div>I also notice the trickiest part of the process: find the file to modify. Do you think that when we tag an issue as easy, we should also add the place to put the changes in the report? Kind of <a href="https://github.com/qgis/QGIS-Documentation/issues/3278#issuecomment-451726082" target="_blank">https://github.com/qgis/QGIS-Documentation/issues/3278#issuecomment-451726082</a> ? I thought about this in the past and finally decided that letting the user browse the repo (or the online doc and use the "fix me" link) to find the appropriate file could be a good learning but maybe it was a bad idea and the curve is a bit high. Should not be hard for us to fix anyway.</div><div><br></div><div>Regards,</div><div>Harrissou<br></div><div>Regards,</div><div>Harrissou<br></div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Le ven. 3 mai 2019 à 14:25, matteo <<a href="mailto:matteo.ghetta@gmail.com" target="_blank">matteo.ghetta@gmail.com</a>> a écrit :<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex">Hi all,<br>
<br>
I can obviously help with QGIS.<br>
<br>
We already have a dedicated chapter where we described all the steps to<br>
contribute:<br>
<br>
<a href="https://docs.qgis.org/testing/en/docs/documentation_guidelines/index.html" rel="noreferrer" target="_blank">https://docs.qgis.org/testing/en/docs/documentation_guidelines/index.html</a><br>
<br>
I'd really like to know if the steps are clear for new tech writers and<br>
what can we do to enhance the process.<br>
<br>
Thanks to all<br>
<br>
Matteo<br>
_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org" target="_blank">SeasonOfDocs@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote></div>
_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org" target="_blank">SeasonOfDocs@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote></div>