Home

Welcome to the Vanderbilt University Enterprise GitHub. Please find information below to get started.

Onboarding

https://github.com/The-Vanderbilt-University/vuit-github-public-src/wiki/Onboarding

Create a Repository

Once you've completed the onboarding process, you may want to create a repository.

Repository Authentication

GitHub no longer supports simple username / password authentication for Git operations.

Multiple authentication options are available but the VUIT GitHub team recommends Personal Access Tokens or SSH Keys. Personal Access Tokens are good for beginners. If you are experienced with SSH keys feel free to use them.

You can find the full documentation here: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/about-authentication-to-github

Tools / Applications

There are many tools that provide access to git repositories.

Lots of users opt for the git command line tool as it provides a consistent interface across many systems.

If you're getting started or just prefer a GUI client, you might try GitHub Desktop.

New to Git?

Git in general

There's lots of video tutorials for git and GitHub. Here's a few to get you started:
Super Short
Short
Medium
Long

The GitHub documentation is quite good.

Pull Requests

Pull requests provide a workflow for merging proposed changes into protected branches. They provide a request mechanism for contributors and a review/approval mechanism for repository owners.

The basic flow works like this:

• Team members clone the repository and create a branch.
• Team members make changes on their branch.
• Team members commit and push their branch and create a pull request.
  • The pull request is a request to pull changes into the protected branch.
• Repository owners review/comment and approve or reject the pull request.
• Once approved, the proposed changes (branch) are merged into the protected branch (typically main).

Checkout the GitHub Documentation for a detailed explanation.