GitHub

GitHub is a web-based Git or Version Control Repository and Internet hosting service. It is mostly used for code. It offers all of the distributed version control and source code management (SCM) functionality of Git as well as adding its own features. It provides access control and several collaboration features such as bug tracking, feature requests, task management, and wikis for every project.

GitHub offers both plans for private and free repositories on the same account which are commonly used to host open-source software projects. As of April 2017, GitHub reports having almost 20 million users and 57 million repositories, making it the largest host of source code in the world.

GitHub has a mascot called Octocat, a cat with five tentacles and a human-like face.

Introduction

Octocat mascot of GitHub

Since the information on GutHub is huge, the documentation is enorm and the issues large it is not always easy to find what you are looking for on the GitHub Website. Therefore this (hopeful) help webpage.

Github flow

At GitHub, we use our products every day and have developed a workflow to collaborate on projects. To make it work for teams regardless of their size or technical expertise, we made sure each step in our workflow can be completed within a web-based interface.

1. Create a branch from the repository, Delete a branch from the repository.
2. Create, edit, rename, move, or [[#Delete file|delete] files.
3. Send a pull request from your branch with your proposed changes to kick off a discussion.
4. Make changes on your branch as needed. Your pull request will update automatically.
5. Merge the pull request once the branch is ready to be merged.
6. Tidy up your branches using the delete button in the pull request or on the branches page.

Create a branch

1. On GitHub, navigate to the main page of the repository.
2. Click the branch selector menu.
3. Type a unique name for your new branch.
4. Press Enter.

Delete a branch

1. On GitHub, navigate to the main page of the repository.
2. Above the list of files, click NUMBER branches.
3. Scroll to the branch that you want to delete, then click the trash-bin.

Create, edit, rename, move, or delete

Create file	Edit file	Rename file	Move file	Delete file
On GitHub, navigate to the main page of the repository. In your repository, browse to the folder where you want to create a file. Above the file list, click Create new file. In the file name field, type the name and extension for the file. To create subdirectories, type the / directory separator. On the Edit new file tab, add content to the file. To review the new content, click Preview. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. Click Propose new file. More...	In your repository, browse to the file you want to edit. In the upper right corner of the file view, click the pencil-icon to open the file editor. On the Edit file tab , make any changes you need to the file. Above the new content, click Preview changes. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. Click Propose file change. More...	In your repository, browse to the file you want to rename. In the upper right corner of the file view, click the pencil-icon to open the file editor. In the filename field, change the name of the file to the new filename you want. You can also update the contents of your file at the same time. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. Click Propose file change. More...	In your repository, browse to the file you want to move. In the upper right corner of the file view, click the pencil-icon to open the file editor. In the filename field, change the name of the file using these guidelines: To move the file into a subfolder, type the name of the folder you want, followed by /. Your new folder name becomes a new item in the navigation breadcrumbs. To move the file into a directory above the file's current location, place your cursor at the beginning of the filename field, then either type ../ to jump up one full directory level, or type the backspace key to edit the parent folder's name. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. Click Propose file change. More...	Browse to the file in your repository that you want to delete. At the top of the file, click the 'Trash-bin'. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. Click Propose file change.

Send a pull request

See https://help.github.com/articles/about-pull-requests

Make changes

Just do the necessary changes.

Merge

See https://help.github.com/articles/merging-a-pull-request

Tidy up

See https://help.github.com/articles/deleting-and-restoring-branches-in-a-pull-request

GitHub Repo Files

GitHub encourages the creation of a number of standard files when adding a project or repository into the VCS. In every sense it is a good practise to do so.

Al files have the extension .md and uses the GitHub Wiki Markup Language MarkDown. Markdown is a way to style text on the web. You control the display of the document; formatting words as bold or italic, adding images, and creating lists are just a few of the things we can do with Markdown. Mostly, Markdown is just regular text with a few non-alphabetic characters thrown in, like # or *.

Markdown Syntax

The MarkDown syntax is explained on https://guides.github.com/features/mastering-markdown.

Text

• '*italic*' , italic by using 1 asterisk
• '**bold**', bold by using 2 asterisks
• [link to Google!](http://google.com) Link to Google

GitHub uses its own version of MarkDown named GitHub Flavored MarkDown (GFM), see https://guides.github.com/features/mastering-markdown/#GitHub-flavored-markdown for more.

Changelog.md

The Changelog.md

Readme.md

The items that may be in a godd readme.md are:

See also

• Git, A VCS Language uses on GitHub.
• GitHub is the best place to share code with friends, co-workers, classmates, and complete strangers. Over eight million people use GitHub to build amazing things together.
  • Guides GitHub, Basic Information (Guides) to Git and the implementation of Git on GitHub.
  • Help GitHub, The best place to look with a massive number of categories and help. A must if you are looking for something.