<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<p>This looks like a great initiative Nick. I'll be really
interested to hear how you go. An outcome out of this could be to
create guidelines for others on how they can set up their own QGIS
Documentation workshop.</p>
<p>I suggest do more than just talk about the technical. Spend a bit
of time explaining to people that they too can be open source
heroes. In fact open source projects like QGIS typically have a
greater need for documentation heroes than to have developer
heroes.</p>
<p>You might want to steal material from: <a
href="http://cameronshorter.blogspot.com/2019/02/inspiring-techies-to-become-great.html">http://cameronshorter.blogspot.com/2019/02/inspiring-techies-to-become-great.html</a>
(note link to my slide deck at top, which you are welcome to copy
from).</p>
<p>Good luck, and please tell us how you go.</p>
<p>Cameron<br>
</p>
<div class="moz-cite-prefix">On 12/9/19 3:02 am, Nick Bearman wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CANsUTf=vK-7RXQLf4W-9NK5N-fDWhAzBYuE4twiddk_QUvR7Ng@mail.gmail.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<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/"
target="_blank" moz-do-not-send="true">QGIS Documentation</a>
at the <a href="https://uk.osgeo.org/foss4guk2019/"
target="_blank" moz-do-not-send="true">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"
target="_blank" moz-do-not-send="true">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"
moz-do-not-send="true">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="m_-6164088214979959515m_-608346822073893651gmail_signature"
data-smartmail="gmail_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"
target="_blank" moz-do-not-send="true">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>
<fieldset class="mimeAttachmentHeader"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..
<a class="moz-txt-link-abbreviated" href="mailto:Qgis-community-team@lists.osgeo.org">Qgis-community-team@lists.osgeo.org</a>
<a class="moz-txt-link-freetext" href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a></pre>
</blockquote>
<pre class="moz-signature" cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</body>
</html>