<html dir="ltr"><head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body style="text-align:left; direction:ltr;"><div>On Wed, 2020-04-29 at 11:22 -0700, Dirk Hohndel via subsurface wrote:</div><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><div>On Wed, 2020-04-29 at 19:15 +0100, Pedro Neves via subsurface wrote:</div><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex">
<div class="moz-cite-prefix">On 29/04/20 18:17, Dirk Hohndel via
subsurface wrote:<br>
</div>
<blockquote type="cite" cite="mid:9834B5EE-A85A-47A5-905F-73610398BC13@hohndel.org" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex">
<div class="">The easiest way might be something like this</div></blockquote></blockquote><div><br></div><div>Actually, I downloaded GitHub Desktop on my Mac to see how that would work for someone who doesn't like the command line and was QUITE impressed. For creating text changes like this it seems like the UI would work very well and most of the steps that are mentioned below become MUCH easier with it. I'll play with it some more and will post an update here once I have concise instructions using that.</div><div><br></div><div>GitHub Desktop has solid support for Mac and Windows and appears to have a snap that is working well "for some" on Linux. But then again, I think that those using a Linux desktop are also somewhat more likely to be comfortable with the command line instructions that I sent out :-)</div></blockquote><div><br></div><div>Oh yeah, I like this for things that don't involve working on code... I tested this on Mac and Windows, I assume that it's not significantly different on Linux (using the snap - googling shows that the snap itself occasionally creates problems)</div><div><br></div><div>(1) install GitHub desktop <a href="https://desktop.github.com">https://desktop.github.com</a></div><div>(2) launch the app, either log in to your account, or create a new one (they will ask you what you do - feel free to say "other" and "translate" and mention "Subsurface" when asked about interests. Or fill in random data). After a bit of back and forth between app, browser, and email (grr) you'll be logged in to your account in the App - in the process please enter your full name and preferred email address (they will be used as Author for your commits)</div><div>(3) click on File->Options->Integrations and pick an external editor - if you don't have a favorite it will offer to install Atom which works really nicely as it also understands git and changes and all that</div><div>(4) back in GitHub Desktop, in the Let's get started screen, click on "Clone a repository from the internet", select "URL" and enter subsurface/subsurface.github.io and click on Clone</div><div>(5) create a branch: click on Current branch in the center, make sure it shows 'master', and then "create new", enter your branch name (for this example: 'demonstratePR')</div><div>(6) on the main screen you'll see that you have no local changes and you'll be given the option to open the repo in your external editor (in this example "Open in Atom") -- click on that</div><div>(7) now you can navigate to the file you want to edit, you can create folders, create files, etc. When you are done and have your changes saved, go back to GitHub Desktop</div><div>(8) in the left column you will now see the changed files, changes on the right. On the bottom left is a window to make a commit. Enter your commit message and click Commit (I'd prefer if you added a "Signed-off-by:" line, but for the GitHub page I'm not going to be too worried about that)</div><div>(9) now you'll see an option to Publish your branch. Most of you don't have write access to our repo, so GitHub desktop will automatically offer you to fork that into your account and create the branch there. Accept that</div><div>(10) next you'll be offered to create a PR (which will take you to the browser where you can complete this step)</div><div><br></div><div>This still is a relatively long process, but I think this will be much easier for people who aren't that comfortable with the command line, git, and all the infrastructure around it. I'll admit that I was really impressed with how smoothly this process went. I created a new GitHub account in order to go through all of these steps, and including writing it all down, installing both GitHub and Atom, and fighting through the change (creating a line in a German translation in a US version of Windows in a VM on a US keyboard where I couldn't figure out where to find the Umlaute) it took me just under 20 minutes to get here. And the next change would likely be just a couple of minutes, now that everything is installed.</div><div><br></div><div>please give it a try and let me know. This might also work well for people working on the user manual, the translations of the user manual (which at this point are all way out of date, btw), the release notes, etc, in the main project.</div><div><br></div><div>Thanks</div><div><br></div><div>/D</div><div></div></body></html>