<html>
<head>
<meta http-equiv="Content-Type" content="text/html;
charset=windows-1252">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<div class="moz-cite-prefix">Hi,
<br>
<br>
The process looks like this:
<br>
<br>
1. You create an account on GitHub
<br>
2. You go to the project you want to work on:
<br>
<a class="moz-txt-link-freetext"
href="https://github.com/OSGeo/OSGeoLive-doc">https://github.com/OSGeo/OSGeoLive-doc</a>
<br>
3. You press the "Fork" button so to get a clone of the project on
your account.
<br>
4. GitHub redirects you to your cloned project:
<br>
<a class="moz-txt-link-freetext"
href="https://github.com/kalxas/OSGeoLive-doc">https://github.com/kalxas/OSGeoLive-doc</a>
<br>
5. You open a terminal on your local machine and copy the code
locally (use your account name where kalxas is):
<br>
$ git clone <a class="moz-txt-link-abbreviated"
href="mailto:git@github.com:kalxas/OSGeoLive-doc.git">git@github.com:kalxas/OSGeoLive-doc.git</a>
<br>
6. Move within your working folder:
<br>
$ cd OSGeoLive-doc
<br>
7. Create a new working branch:
<br>
$ git checkout -b work-1
<br>
8. Do your edits to the files you want. In your case you can just
copy the file you already have edited and replace the previous
copy of that file.
<br>
9. See the changes before you commit them to git. Use the
following commands to see your status:
<br>
$ git diff
<br>
$ git status
<br>
10. Lets assume you edited README.rst. git status will show you
that file as changed. You need to tell git that you want to commit
this file in the next step
<br>
$ git add README.rst
<br>
11. You can go back to step 8 and continue working or just do this
commit with this one file
<br>
$ git commit -m "Commit message here"
<br>
12. Once you have committed the change git status will show clean
status now. You can now push your working branch to your GitHub
account with
<br>
$ git push origin work-1
<br>
13. Now you need to go back to the web interface at <a
class="moz-txt-link-freetext"
href="https://github.com/kalxas/OSGeoLive-doc">https://github.com/kalxas/OSGeoLive-doc</a>,
navigate to the "work-1" branch and press the button that says
"New Pull Request".
<br>
14. Wait until your pull request gets commented, perhaps changes
will be asked to be made and finally it will get accepted.
<br>
15. Back to the terminal you can get code changes from others by
going back to "master" branch and getting code from the main
repository (<a class="moz-txt-link-freetext"
href="https://github.com/OSGeo/OSGeoLive-doc.git">https://github.com/OSGeo/OSGeoLive-doc.git</a>).
<br>
$ git checkout master
<br>
$ git remote add upstream <a class="moz-txt-link-freetext"
href="https://github.com/OSGeo/OSGeoLive-doc.git">https://github.com/OSGeo/OSGeoLive-doc.git</a>
<br>
$ git pull upstream master
<br>
<br>
Hope this mini tutorial helps,
<br>
Angelos</div>
<div class="moz-cite-prefix"><br>
</div>
<div class="moz-cite-prefix">On 12/2/18 9:03 AM, Johanna Botman
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:001b01d48a0d$252840f0$6f78c2d0$@jbotman.com">
<pre class="moz-quote-pre" wrap="">Hi,
Can someone give me a step by step of how I submit my edited Quick Start
document?
I have looked at the Getting Started guide in Github, but it describes
setting up my own project. I need to know how to contribute to a project.
I have created a version of the documents in my virtual machine. I can't see
how that links back to Git Hub. Can someone assist?
Johanna
</pre>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
osgeolive mailing list
<a class="moz-txt-link-abbreviated" href="mailto:osgeolive@lists.osgeo.org">osgeolive@lists.osgeo.org</a>
<a class="moz-txt-link-freetext" href="https://lists.osgeo.org/mailman/listinfo/osgeolive">https://lists.osgeo.org/mailman/listinfo/osgeolive</a>
</pre>
</blockquote>
<p><br>
</p>
<pre class="moz-signature" cols="72">--
Angelos Tzotsos, PhD
Charter Member
Open Source Geospatial Foundation
<a class="moz-txt-link-freetext" href="http://users.ntua.gr/tzotsos">http://users.ntua.gr/tzotsos</a></pre>
</body>
</html>