<div dir="ltr"><div>Hi Nick,</div><div><br></div><div>Thanks for this initiative. Good to know. We'll try to be responsive to the PRs so that they really see how quickly and easily they can contribute to the project. I guess you already know about the step-by-step guidelines [1] (which shows that git is not a requirement for anyone willing to step in documentation); there are also some video materials [2] Alexandre Neto has recently pushed online that can be of interest for people.<br></div><div><br></div><div></div><div>About using Ubuntu, we have decided months ago that it's no longer a requirement. If you browse the docs we already have a mixture of different platforms. So good to do with what your attendees have. Guidelines were not updated accordingly. Should be fixed after [3].<a href="https://github.com/qgis/QGIS-Documentation/pull/4229" target="_blank"></a></div><div><br></div><div>About the easy tags, that's too bad! I've closed a bunch of them few days ago. I'd have known... Anyways, what would be the QGIS version of your audience? Browsing the list of "easy"-tagged issues, many are of 3.10 milestone, meaning QGIS master. I'm not sure it's what people will be using. So it could be nice if we can do some efforts to tag more "easy" issues in older releases beforehand. "Processing Alg" tagged issues [3] are not necessarily set as easy but they could be; most of the times, it's about copy-pasting an older one and do the few tweaks relative to the alg.</div><div></div><div><br></div><div>Régis, I think Documentation (and translation, for non english communities) are workshops we should try to always have in our meetings (foss4g FR but also QGIS FR)</div><div><br></div><div>Have fun, and yes, tell us how you go.<br></div><div></div><div><br></div><div>[1] <a href="https://docs.qgis.org/testing/en/docs/documentation_guidelines/first_contribution.html">https://docs.qgis.org/testing/en/docs/documentation_guidelines/first_contribution.html</a></div><div>[2] <a href="https://www.youtube.com/watch?v=PCiohDt-OBk">https://www.youtube.com/watch?v=PCiohDt-OBk</a> for the part 1</div><div>[3]<a href="https://github.com/qgis/QGIS-Documentation/pull/4229" target="_blank">https://github.com/qgis/QGIS-Documentation/pull/4229</a></div><div>[4] <a href="https://github.com/qgis/QGIS-Documentation/issues?q=is%3Aopen+is%3Aissue+label%3A%22Processing+Alg%22">https://github.com/qgis/QGIS-Documentation/issues?q=is%3Aopen+is%3Aissue+label%3A%22Processing+Alg%22</a></div><div><br></div><div>Regards,</div><div>Harrissou<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Le jeu. 12 sept. 2019 à 08:17, Régis Haubourg <<a href="mailto:regis.haubourg@gmail.com">regis.haubourg@gmail.com</a>> a écrit :<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="auto">Hi Nick, <div dir="auto">Great move. I think I will push the idea of documentation and translation workshops for the next foss4g FR. If we can achieve nice material, we could even go to something that can be used by all user groups with osgeolive easily. My idea would be to attempt to have local user groups, universities, engineer schools use it everywhere. </div><div dir="auto">Tell us how it goes!</div><div dir="auto"><br></div><div dir="auto">Concerning the Ubuntu use, I have no opinion at this stage.</div><div dir="auto">Régis </div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Le mer. 11 sept. 2019 à 19:10, Nick Bearman <<a href="mailto:nick@geospatialtrainingsolutions.co.uk" target="_blank">nick@geospatialtrainingsolutions.co.uk</a>> a écrit :<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div>Hello,</div><div><br></div><div>I am running a short (90 min) session on <a href="https://b-rowlingson.gitlab.io/workshopbookings/contributing-to-qgis-documentation/" rel="noreferrer" target="_blank">QGIS Documentation</a> at the <a href="https://uk.osgeo.org/foss4guk2019/" rel="noreferrer" target="_blank">FOSS4G UK 2019 Conference in Edinburgh</a>. The session is next Friday and I wanted to give you (QGIS Documentation Team) the heads up (as I plan to actually get people to do some editing for QGIS Documentation in the session) and ask a couple of questions. </div><div><br></div><div><i>Firstly, apologies for the late notice of this - I have been manically busy so have not been able to put as much time into this as I would have liked. </i></div><div><i>Secondly, just for background I have been following the discussions from Cameron / Andreas / Regis / Matteo / Anita / Harrissou / Alexandre and others on SeasonOfDocs and QGIS, which has been very interesting. Thanks all for your comments, and sorry I could not take part more in this. </i><br></div><div><br></div><div>It is a fairly short session and I want people to get something tangible out of this. I am planning to start off with an explanation of the QGIS Documentation, why it is important to contribute and so on. The attendees in the session are likely not to have any experience of Git, so I am planning on walking them through the process of making a fork, editing a file and submitting a PR on an example repository, so they get used to the principles. Then I will explain how QGIS Documentation on GitHub works, and I would ideally like to be able to get them to actually make an edit and submit a PR on the real documentation. I have seen the list of Easy issues (<a href="https://github.com/qgis/QGIS-Documentation/issues?q=is%3Aopen+is%3Aissue+label%3AEasy" rel="noreferrer" target="_blank">https://github.com/qgis/QGIS-Documentation/issues?q=is%3Aopen+is%3Aissue+label%3AEasy</a>) and am going to suggest they each try one of those. There are quite a few screenshots / new features ones so will direct them towards these. <br><br>One thing I would like to highlight / question is that on <a href="https://docs.qgis.org/testing/en/docs/documentation_guidelines/writing.html#managing-screenshots" rel="noreferrer" target="_blank">https://docs.qgis.org/testing/en/docs/documentation_guidelines/writing.html#managing-screenshots</a> page, the info for screenshots implies that a Ubuntu operating system is required to make screenshots. Is this the case? I can see how this is a nice to have for consistency, but I think this is a blocker for anyone who wants to contribute screenshots who doesn't use Ubuntu (and I think that is a large chunk of people). There is some infrastructure for screenshots already, so should I advise newbies to have a go at screenshots (neglecting the requirement for Ubuntu/Unity), or are there better areas for them to focus on?</div><div><br>After they have made a change, I will ask them to tag me (@nickbearman) in the PR comments, so I can track contributions and help/comment as required. <br><br>I have also been asked to lead a session on QGIS Documentation on the Saturday hackathon, so I hope to get some larger bits done myself as well. <br><br>I hope this is useful as a heads up for you. Do you have any suggestions for newbie issues to recommend them? I'm also open to any other comments and suggestions that people would like to make. <br><br>Best wishes,<br>Nick.<br></div><div><br></div><div>-- <br><div dir="ltr" class="gmail-m_4803395393863537274m_4049146369007242250m_-6164088214979959515m_-608346822073893651gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr">Nick Bearman<div dir="ltr" style="font-size:small">01209 808910 | 07717745715</div><div style="font-size:small"><a href="mailto:nick@geospatialtrainingsolutions.co.uk" rel="noreferrer" target="_blank">nick@geospatialtrainingsolutions.co.uk</a></div><div style="font-size:small"><br></div><div style="font-size:small">Due to my own life/work balance, you may get emails from me outside of
 normal working hours. Please do not feel any pressure to respond 
outside of your own working pattern.</div></div></div></div></div></div></div></div>
_______________________________________________<br>
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
<a href="mailto:Qgis-community-team@lists.osgeo.org" rel="noreferrer" target="_blank">Qgis-community-team@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a></blockquote></div>
_______________________________________________<br>
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
<a href="mailto:Qgis-community-team@lists.osgeo.org" target="_blank">Qgis-community-team@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a></blockquote></div>