Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
layout: default
title: home
---
# My GitHub Pages site

## Basic terminology

You can think of a Git _repository_ as the folder for your project that contains all the component files, such as code, documentation, and examples. You can store your repositories on GitHub, where they can be publicly visible (open source) or be private and only accessible to certain users.

When you start working on a project, you need to make your own _branch_ of a repository, which is a parallel version that contains your changes. As you make modifications, like adding or deleting lines of code or files, you save, or _commit_, your changes.

To propose integrating your commits into the production version of the project, known as the _master branch_, you open a _pull request_. A pull request is the way you start a discussion with others about your changes. Other _collaborators_ on the project can review and approve your work. After your pull request is _merged_, your changes are added to the master branch.

You can review the [GitHub Glossary](https://help.github.com/articles/github-glossary/) to learn more about common terms.

## General workflow for making a website with GitHub Pages

You can follow these general instructions to make a website with GitHub Pages.

1. Create a new repository for your site.
2. Create a branch to hold your changes.
2. Add some files for your website. At a minimum, you need a file for the homepage. You can name this file index.md and use markdown formatting, or index.html and add the basic HTML page structure.
3. Open a pull request to propose adding your changes into the master branch.
4. Merge files into the master branch.
5. Go to the repository settings and enable GitHub Pages on the master branch.
6. Open browser to the page.