GitHub/Get Started

From Wikiversity
Jump to navigation Jump to search

To get started with GitHub, you will need to create a user account and then create a repository. In this lesson you will also use the web interface to create a README.md file, add files and folders to the repository, and then delete files and delete the repository.

Join GitHub[edit | edit source]

  1. Review GitHub: Signing up for a new GitHub account
  2. Visit GitHub: Join GitHub
  3. Enter your username, email address, and password.
  4. Verify your account.
  5. Choose the free individual plan.

Apply for a GitHub Student Developer Pack[edit | edit source]

  1. Review GitHub: Apply for a student developer pack.
  2. Visit GitHub: Student Developer Pack.
  3. Select Get your pack.
  4. Follow the instructions to apply for a GitHub Student Developer Pack.

Create a Repository[edit | edit source]

  1. Review GitHub: Create a Repo.
  2. Visit GitHub and sign in to your account.
  3. Select Repositories / New.
  4. Enter Test for the repository name.
  5. Select the option to make it a private repository. (Note: A public repository can only be viewed as a website when using GitHub Free.)
  6. Select the option to Initialize this repository with a README.
  7. Create the repository.

Edit the README[edit | edit source]

  1. Review GitHub: Editing Files in Your Repository.
  2. Select the link to your README.md file to open the file.
  3. Select the Edit this file icon (pencil) to edit the file.
  4. The README may contain anything you like. Because it is a private repository, only you and users you invite will be able to see this repository.
  5. Commit the change to modify the README file.
  6. Observe the new front page for your repository.
  7. If desired, edit the README and commit additional changes now that you are able to see how the README will appear.

Create a File[edit | edit source]

GitHub repositories are typically managed using the git command line or a git utility. But it is also possible to edit content directly using the GitHub website.

  1. In your GitHub repository select Create new file.
  2. Enter test.txt for the filename.
  3. Enter anything you wish for the file content.
  4. Commit the change.

Edit a File[edit | edit source]

  1. Select test.txt.
  2. Select the Edit this file icon (pencil) to edit the file.
  3. Change the file content to anything you wish, but something different so you can see the change.
  4. Select Preview changes to see the change.
  5. Commit the change.

Create a Folder and File[edit | edit source]

  1. In your GitHub repository select Create new file.
  2. Enter My Folder/My File.txt for the filename.
  3. Enter anything you wish for the file content.
  4. Commit the change.

Add Collaborators[edit | edit source]

  1. In your GitHub repository select Settings.
  2. Select Manage access.
  3. Select Invite a collaborator.
  4. Enter the GitHub username of anyone you would like to have collaborate with you on your repository. Collaborators will have write access.
  5. Select Add collaborator to send a collaboration invitation.

Delete a Folder and File[edit | edit source]

  1. In your GitHub repository select My Folder.
  2. Select My File.txt to view the file.
  3. On the right, select the Delete this file (trash can icon).
  4. Commit the change.
  5. Observe that an empty folder is automatically removed from a git repository.

Delete a Repository[edit | edit source]

  1. In your GitHub repository at the top, select Settings.
  2. Observe the repository options available.
  3. At the bottom of the page, select Delete this repository.
  4. Delete your Test repository.

Use GitHub[edit | edit source]

You are now ready to use GitHub and create your own repository.

See Also[edit | edit source]