<div dir="auto">We can offer both contribution pathways to folks and they can choose what they want based on the way they prefer to work.<div dir="auto"><br></div><div dir="auto">I don't think it needs to be either-or.</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon., 29 Jul. 2019, 21:46 Jo Cook, <<a href="mailto:jo.k.cook@gmail.com">jo.k.cook@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>My personal preference would be to guide people towards using the github interface itself rather than asking them to install github desktop and an IDE.  I think those requirements alone will bar people in corporate environments from being able to help contribute as they won't be able to install software on their machines. I admit also that would be enough to put me off, if I was just looking to correct a typo, and I've had similar feedback from people I've asked about this in the past.</div><div><br></div><div>Furthermore, it might be seamless to pull/fetch/commit using github desktop, but those are new terms to a lot of people, and again it's off-putting if all you want to do is change once sentence in a text file.</div><div><br></div><div>Jo<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Jul 29, 2019 at 12:41 AM Sanket Totewar <<a href="mailto:sanket@totewar.com" target="_blank" rel="noreferrer">sanket@totewar.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 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" target="_blank" rel="noreferrer">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 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" rel="noreferrer">SeasonOfDocs@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" rel="noreferrer 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" rel="noreferrer">SeasonOfDocs@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" rel="noreferrer noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote></div><br clear="all"><br>-- <br><div dir="ltr" class="m_4911500505679202329gmail_signature">------------------------<br><a href="http://about.me/jocook" target="_blank" rel="noreferrer">http://about.me/jocook</a></div>
_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org" target="_blank" rel="noreferrer">SeasonOfDocs@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" rel="noreferrer noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote></div>