Skip to content

Commit

Permalink
Github description updated
Browse files Browse the repository at this point in the history
  • Loading branch information
vogella committed Oct 28, 2016
1 parent 270f128 commit f31186c
Show file tree
Hide file tree
Showing 2 changed files with 45 additions and 92 deletions.
137 changes: 45 additions & 92 deletions GitHub/100_github.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,57 +3,27 @@

[[hosting_github_what]]
=== What is GitHub?

(((GitHub)))
GitHub
is a popular hosting provider for Git repositories. GitHub
provides also additional services around these repositories, for
example an issue tracker for each repository, build server
integration and more.

GitHub supports that repositories can be cloned
to a new Git
repository hosted at Github. GitHub uses the term
_fork_
or
_forking_
for creating such clones.
is a popular hosting provider for Git repositories.
GitHub provides additional services around these repositories.
For example, it provides an issue tracker for each repository, build server integration and more.

GitHub
provides
free hosting for publicly visible
Git
repositories.
A
public
repository can be cloned by other people
at
any point in
time.

If the repository should not be visible to everyone, Git allows
to create private repositories, but you must pay for this service a
monthly rate.
Private repository allows you to
specify the
people which
have access
to the
repository and to define their access
rights.

GitHub can be found
under the following
URL: https://github.com[GitHub]
GitHub supports that repositories can be cloned to a new Git repository hosted at Github.
GitHub uses the term _fork_ or _forking_ for creating such clones.

GitHub provides free hosting for publicly visible Git repositories.
A public repository can be cloned by other people at any point in time.

If the repository should not be visible to everyone, Git allows to create private repositories, but you must pay for this service a monthly rate.
Private repository allows you to specify the people which have access to the repository and to define their access rights.

GitHub can be found under the following URL: https://github.com[GitHub]

If you create an account at GitHub, you can create a repository.
After
creating a repository at GitHub, you will get a description of
all the
commands you need
to execute to upload your project to GitHub.
Follow
the
instructions below.
After creating a repository at GitHub, you will get a description of all the commands you need to execute to upload your project to GitHub.
Follow the instructions below.

These instructions will be similar to the following commands.

Expand All @@ -62,78 +32,61 @@ These instructions will be similar to the following commands.
include::res/github/example.txt[]
----

GitHub allows you to use SSH based or HTTPS based authentication
to
access your
repositories. To clone, pull or fetch from a public
available repository no authentication is required.
GitHub allows you to use SSH based or HTTPS based authentication to access your repositories.
To clone, pull or fetch from a public available repository no authentication is required.

[[github_createrepo]]
=== Create repository in GitHub

Once you create a user at Github, you can create a new public
repository. For example the following screenshots demonstrate the
creation of
the
_de.vogella.git.github_
repository.
Once you create a user at Github, you can create a new public repository.
For example, the following screenshots demonstrate the creation of the _de.vogella.git.github_ repository.

image::github10.png[Creating GitHub repository step 1]

image::github20.png[Creating GitHub repository step 2]

After creation of your new repository GitHub displays the
information what you have to
do if you want to connect to this
repository via the command line. As
we are going to use
EGit you can
ignore this information.
After creation of your new repository GitHub displays the information what you have to do if you want to connect to this repository via the command line.




[[hosting_github_mergingpullrequests]]
=== Merging pull request at GitHub
(((GitHub,Merging pull requests)))
GitHub uses
_Pull requests_
for contributions.

The typical workflow in GitHub is to fork a repository, create
changes in your fort and send a pull request to the origin repository
via the
GitHub webinterface.
(((GitHub,Merging pull requests)))
GitHub uses _Pull requests_ for contributions.

The typical workflow in GitHub is to fork a repository, create changes in your fork and send a pull request to the origin repository via the GitHub webinterface.

GitHub makes is easy to fork a repository via its web interface.
Simply click the
btn:[Fork]
button of a repository of your choice.
Simply click the btn:[Fork] button of a repository of your choice.

image::github_pullrequest10.png[Forking a GitHub repository]

You can now clone this fork to your local development
environment and push the changes to this fork at GitHub.
You can now clone this fork to your local development environment and push the changes to this fork at GitHub.

Afterwards you can create a pull request for the repository you
forked
from. Your
repository is the fork as highlighted in the
screenshot. Press
_Pull Requests_
to see existing and create new pull requests.
Afterwards you can create a pull request for the repository you forked from.
Your repository is the fork as highlighted in the screenshot.
Press _Pull Requests_ to see existing and create new pull requests.

image::github_pullrequest20.png[Creating a pull request for Github, Part 1]

Click
_New pull request_
to create a new one.
Click _New pull request_ to create a new one.

image::github_pullrequest30.png[Creating a pull request for Github, Part 2]

On the next screen you can specify the direction of the pull request
and the branches if you select the
_Edit_
button.
On the next screen you can specify the direction of the pull request and the branches by selecting the _Edit_ button.

image::github_pullrequest40.png[Creating a pull request from Github, Part 3]

If the owner of the repository accepts your pull request your changes are integrated into the original repository.
If the owner of the repository accepts your pull request, your changes are integrated into the original repository.

[[locally_evaluating_github_pullrequests]]
=== Locally evaluating Github pull requests

You can also pull the changes in a Github pull request into your local Git repository to test it.
Each pulll request has a link which once clicked shows you the corresponding commands.

image::github_local_clone_pullrequest.png[Getting the changes of a Github Pull request into your local repo]


Binary file added GitHub/img/github_local_clone_pullrequest.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit f31186c

Please sign in to comment.