<div dir="ltr"><div class="gmail_default" style="font-family:verdana,sans-serif">Thanks for creating a separate thread. It's a great question.</div><div class="gmail_default" style="font-family:verdana,sans-serif"><br></div><div class="gmail_default" style="font-family:verdana,sans-serif">Just a thought - I reckon most writers are familiar with Google Docs or Microsoft Word so we might vote and look into creating a 2-way integration between GitHub and Google Docs/Office 365.</div><div class="gmail_default" style="font-family:verdana,sans-serif"><br></div><div class="gmail_default" style="font-family:verdana,sans-serif">Alternatively, we could create a document on how to use GitHub Desktop for our project. With Atom or another supported IDE installed (to edit the files in markdown), it's seamless to pull, fetch, commit, etc.</div><div class="gmail_default" style="font-family:verdana,sans-serif"><br></div><div class="gmail_default" style="font-family:verdana,sans-serif">I'll be happy to own the latter if enough people vote on this.<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Jul 29, 2019 at 8:51 AM 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">On 29/7/19 7:21 am, Jennifer Rondeau wrote:<br>
> Related but not quite on topic: how do we want to solicit and <br>
> encourage contributions? Are we assuming only contributors who are <br>
> already familiar with a Git workflow? That would definitely keep some <br>
> good work away, based on my experience with writing day sessions for <br>
> the Write the Docs guide at WtD conferences.<br>
<br>
Folks,<br>
<br>
I've changed the title of this email in order to create a different <br>
thread. In email lists we've found it reduces confusion when we stick to <br>
one topic per thread.<br>
<br>
Jennifer, good question, and one I touched on in <br>
<a href="http://cameronshorter.blogspot.com/2019/02/inspiring-techies-to-become-great.html" rel="noreferrer" target="_blank">http://cameronshorter.blogspot.com/2019/02/inspiring-techies-to-become-great.html</a><br>
<br>
I wish there were tools that allow a writer to add track changes and <br>
comments as easily as Google Docs or Word, but also have the rigour and <br>
accountability provided by git. I don't think tools are there yet, so we <br>
need to compromise.<br>
<br>
I think that rigour is important for the long term, and so I feel we <br>
need to make use of git from the start, and we can encourage tool <br>
builders to improve usability in the long term.<br>
<br>
I'm starting to form the opinion that in the interim, we should <br>
encourage use of track changes in Google Docs for first round <br>
brain-storming, then we should switch across to git.<br>
<br>
-- <br>
Cameron Shorter<br>
Technology Demystifier<br>
Open Technologies and Geospatial Consultant<br>
<br>
M +61 (0) 419 142 254<br>
<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>