Markdown is a text-to-HTML conversion tool for web writers: [Markdown] (http://daringfireball.net/projects/markdown/syntax] "syntax")
a repository is usually used to organize a single project.
- Repositories can contain folders and files, images, videos, spreadsheets, and data sets – anything your project needs.
- We recommend including a README, or a file with information about your project.
a commit is the making of a set of tentative changes permanent.
After your new repository, Create a Branch Branching is the way to work on different versions of a repository at one time. By default your repository has one branch named master which is considered to be the definitive branch. We use branches to experiment and make edits before committing them to master. To create a new branch:
- Go to your new repository hello-world.
- Click the drop down at the top of the file list that says branch: master.
- Type a branch name, readme-edits, into the new branch text box.
- Select the blue Create branch box or hit “Enter” on your keyboard.
Now you have two branches, master and readme-edits. They look exactly the same, but not for long! Next we’ll add our changes to the new branch. Let’s make some edits. On GitHub, saved changes are called commits and each commit has an associated commit message, which is a description explaining why a particular change was made. Commit messages capture the history of your changes, so other contributors can understand what you’ve done and why.
Now that you have changes in a branch off of master, you can open a pull request. Pull Requests are the heart of collaboration on GitHub. When you open a pull request, you’re proposing your changes and requesting that someone review and pull in your contribution and merge them into their branch. Pull requests show diffs, or differences, of the content from both branches. The changes:
- additions, is shown in green
- subtractions is shown in red
As soon as you make a commit, you can open a pull request and start a discussion, even before the code is finished.
In this final step, it’s time to bring your changes together – merging your readme-edits branch into the master branch.
- Click the green Merge pull request button to merge the changes into master.
- Click Confirm merge.
- Go ahead and delete the branch, since its changes have been incorporated, with the Delete branch button in the purple box.