<div dir="ltr"><div>Hi Belinda and Liam,</div><div>It was great to have breakfast with you this morning and discuss how you might want to get involved in SeasonOfDocs.</div><div>As promised, here is an email thread with ideas so far about updating Quickstarts/Overviews for QGIS which will be a really good starting point for you both (with your QGIS background).</div><div><br></div><div>The How to Get started with OSGeoLive docs is halfway through transitioning from an old system to new (sorry for the mess):</div><div>Old: <a href="https://wiki.osgeo.org/wiki/OSGeoLive_AddProject#Documentation">https://wiki.osgeo.org/wiki/OSGeoLive_AddProject#Documentation</a></div><div>New: <a href="https://trac.osgeo.org/osgeolive/wiki/How%20to%20document%20a%20project">https://trac.osgeo.org/osgeolive/wiki/How%20to%20document%20a%20project</a></div><div><br></div><div>If you get stuck, which is highly likely, feel free to ask one of us CCed.</div><div><br></div><div>Good luck, Cameron</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, 25 May 2019 at 06:20, Cameron Shorter <<a href="mailto:cameron.shorter@gmail.com">cameron.shorter@gmail.com</a>> wrote:<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>Hi Harrissou, my comments are inline:</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, 24 May 2019 at 19:48, DelazJ <<a href="mailto:delazj@gmail.com" target="_blank">delazj@gmail.com</a>> wrote:<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>Hi all,</div><div><br></div><div>Nicolas, what's the deadline for the release?</div></div></blockquote><div><br></div><div>Our OSGeoLive schedule is here: <a href="https://docs.google.com/spreadsheets/d/1kO6zzmLFfprZGgp5x7Sjwi-EVN6NTGDR4KXvFVtNpR0/edit?hl=en_GB&hl=en_GB#gid=0" target="_blank">https://docs.google.com/spreadsheets/d/1kO6zzmLFfprZGgp5x7Sjwi-EVN6NTGDR4KXvFVtNpR0/edit?hl=en_GB&hl=en_GB#gid=0</a></div><div>English versions of Project Overviews and Quickstarts are to be updated and reviewed by 9 July 2019</div><div><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>I think you hit two items that are not covered even in our official documentation so tackling these would benefit to both docs:</div><div>- the Overview: we have a list of features at [1] but it's also not fully updated at the moment [2}</div><div>- the Quickstart (something we don't have): but we neither finished updating our screenshots [3] - some might already be available to pick in the repo though.<br></div><div><br></div><div>What I want to say, refering to our own undone changes, is that this is an opportunity to fix two important features for both projects.</div></div></blockquote><div><br></div><div>I agree Harrissou, aligning QGIS and OSGeoLive core documentation would be excellent. It is something I'm hoping we can trail in our SeasonOfDocs initiative with QGIS and GeoNetwork, and later introduce to other OSGeo projects.</div><div> </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> And afaics it doesn't require specific advanced skills, so I'd invite people willing to help in documentation to give it a try. Could be a good starting point. The visual changelogs might also help to find some main features [4].<br></div></div></blockquote><div><br></div><div>Yes, these are less complicated tasks and a good starting point. I've been learning from tech writers that we should be careful to avoid words like "easy", or "just do ....". Tasks which developers find easy (like using git or RST) have a high barrier-to-entry for experienced writers (such as an ex-English teacher who came to our last FOSS4G community day).</div><div><br></div><div>Our Howto-write-OSGeoLive docs have become harder to follow as we have been automating our build process. (I'm hoping we will improve this as part of SeasonOfDocs). Links from: <a href="https://trac.osgeo.org/osgeolive" target="_blank">https://trac.osgeo.org/osgeolive</a></div><div><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></div><div><br></div><div>About OSGeoLive, am I right that there's no html doc online and if i want to view the docs I have to either run the dvd/usb/VM or build it myself as explained in the ReadMe [5]?</div></div></blockquote><div><br></div><div>You can see docs from our latest release here: <a href="http://live.osgeo.org/en/overview/overview.html" target="_blank">http://live.osgeo.org/en/overview/overview.html</a> </div><div><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>Regarding the quickstart (<i>talking about the concept of quickstart since I haven't seen the OSGeoLive's one and don't know if it duplicates things we already have</i>), I wonder if it's not something we can consider having next or within QGIS docs. There might be ways to bridge both resources, actually just display on QGIS Docs website the quickstart from OSGeoLive-Docs. Sphinx-gurus? And that would help QGIS documenters be more concerned (talking about me at least) with OSGeoLive docs, bridge the projects and there might be more advantages.</div></div></blockquote><div><br></div><div>Yes, I really like this idea, and would be interested to see how we can pursue this.</div><div> </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><br></div><div>Regards,</div><div>Harrissou<br></div><div><br></div><div>[1] <a href="https://docs.qgis.org/3.4/en/docs/user_manual/preamble/features.html" target="_blank">https://docs.qgis.org/3.4/en/docs/user_manual/preamble/features.html</a></div><div>[2] <a href="https://github.com/qgis/QGIS-Documentation/issues/2286" target="_blank">https://github.com/qgis/QGIS-Documentation/issues/2286</a></div><div>[3] <a href="https://github.com/qgis/QGIS-Documentation/issues/2441" target="_blank">https://github.com/qgis/QGIS-Documentation/issues/2441</a></div><div>[4] <a href="https://qgis.org/en/site/forusers/visualchangelogs.html" target="_blank">https://qgis.org/en/site/forusers/visualchangelogs.html</a></div><div>[5] <a href="https://github.com/OSGeo/OSGeoLive-doc#building-osgeolive-documentation" target="_blank">https://github.com/OSGeo/OSGeoLive-doc#building-osgeolive-documentation</a></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Le jeu. 23 mai 2019 à 09:33, Nicolas Roelandt <<a href="mailto:roelandtn.pro@gmail.com" target="_blank">roelandtn.pro@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="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div>Hi dear QGIS community members,</div><div><br></div><div>OSGeoLive has reached alpha2 stage with QGIS 3.4.6 installed. [1]</div><div>OSGeoLive 12.0 was with QGIS 2.18 and the current documentation was written for this version.</div><div><br></div><div>At OSGeoLive, we think that the new version of QGIS is a
good opportunity to rework on the QGIS overview [2] and quickstart [3] and reflects its new functionnalities. So we are looking for volunteers to help us improve the docs and take new screenshots.</div><div><br></div><div>You can work directly on the files or interact in the dedicated ticket [4] or within our mailing list [5].</div><div><br></div><div>Thanks for your help from the OSGeoLive Community.<br></div><div><br></div><div>Yours sincerely,</div><div><br></div><div><div dir="ltr" class="gmail-m_1237828683431266044gmail-m_364191935968451013gmail-m_-4376049172358921139gmail_signature"><div dir="ltr"><div><div><div>Nicolas Roelandt</div><div>OSGeoLive PSC</div><div>OSGeo-fr board</div><div>OSGeo charter member</div><div><br></div><div>[1] <a href="http://osgeo-org.1560.x6.nabble.com/OSGeoLive-13-0-status-alpha2-td5405559.html" target="_blank">http://osgeo-org.1560.x6.nabble.com/OSGeoLive-13-0-status-alpha2-td5405559.html</a></div><div>[2] <a href="https://github.com/OSGeo/OSGeoLive-doc/blob/master/doc/overview/qgis_overview.rst" target="_blank">https://github.com/OSGeo/OSGeoLive-doc/blob/master/doc/overview/qgis_overview.rst</a></div><div>[3] <a href="https://github.com/OSGeo/OSGeoLive-doc/blob/master/doc/quickstart/qgis_quickstart.rst" target="_blank">https://github.com/OSGeo/OSGeoLive-doc/blob/master/doc/quickstart/qgis_quickstart.rst</a></div><div>[4] <a href="https://trac.osgeo.org/osgeolive/ticket/2136#ticket" target="_blank">https://trac.osgeo.org/osgeolive/ticket/2136#ticket</a></div><div>[5] <a href="mailto:osgeolive@lists.osgeo.org" target="_blank">osgeolive@lists.osgeo.org</a><br></div><span dir="ltr"><a href="https://twitter.com/RoelandtN42" rel="noopener" target="_blank"><span dir="ltr"></span></a></span></div></div></div></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" 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>
_______________________________________________<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><div><br></div></div>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div><div><span style="font-size:12.8px">Cameron Shorter</span><br></div><div>Technology Demystifier</div><div>Open Technologies and Geospatial Consultant</div><div><br></div><div>M +61 (0) 419 142 254</div><div><br></div></div><div><br><br></div></div></div></div></div></div></div></div></div></div>