https://github.com/jonico/get-started-with-github
First steps into GitHub
https://github.com/jonico/get-started-with-github
Last synced: over 1 year ago
JSON representation
First steps into GitHub
- Host: GitHub
- URL: https://github.com/jonico/get-started-with-github
- Owner: jonico
- License: apache-2.0
- Created: 2019-01-25T08:21:00.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-02-02T09:28:47.000Z (over 6 years ago)
- Last Synced: 2025-01-14T02:32:27.136Z (over 1 year ago)
- Homepage: https://jonico.github.io/get-started-with-github/
- Size: 166 KB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Get started with GitHub
# 🎯 Purpose
The purpose of this guide is to give you the basic information you need to get going with GitHub. This guide is intended to be used for GitHub in a common configuration. It is not the end all and be all of the information available to help you succeed with GitHub, but is a curated list of the following GitHub resources as well as other public sources of information:
- [GitHub User Help Docs](https://help.github.com/)
- [GitHub Enterprise Help Docs](https://help.github.com/enterprise)
- [GitHub Services Resources](https://services.github.com/on-demand/resources/)
- [GitHub Resources](https://resources.github.com/)
- [GitHub Guides](https://guides.github.com/)
- [GitHub Videos](https://www.youtube.com/user/GitHubGuides/)
## Example how to link to additional markdown files in the same repository
* [GitHub Enterprise FAQ - Deutsch](github-enterprise-faq-deutsch)
# :octocat: The GitHub Platform
GitHub is more than "version control"; it is an all-inclusive and unified collaboration platform:
# ⏩ Get Going!
- 💻 [Get Distributed](#-get-distributed)
- ⚙️ [Get Installed *](#️-get-installed-)
- 🔧 [Get Configured *](#-get-configured-)
- 📁 [Get Organized](#-get-organized)
- :key: [Get Access](#key-get-access)
- :nut_and_bolt: [Get Setup](#nut_and_bolt-get-setup)
- 🌊 [Get Flowing](#-get-flowing)
- ✅ [Get Managing](#-get-managing)
- :books: [Get Documented](#books-get-documented)
- 🔗 [Get Integrated](#-get-integrated)
- ⬆️ [Get Upgraded *](#️-get-upgraded-)
- 📢 [Get Informed](#-get-informed)
- 🆘 [Get Help](#-get-help)
- 🌐 [Get Open Sourcing](#-get-open-sourcing)
* ENTERPRISE ONLY
## 💻 Get Distributed
Get familiarized with why modern distributed version control is an improvement over traditional centralized version control
- [About Version Control](https://git-scm.com/book/en/Getting-Started-About-Version-Control) (Distributed vs. Centralized)
- [Git Basics](https://git-scm.com/book/en/Getting-Started-Git-Basics) (Snapshots vs. Differences)
- [Intro to Distributed Version Control](https://betterexplained.com/articles/intro-to-distributed-version-control-illustrated/) (vs. Centralized Version Control)
## ⚙️ Get Installed *
Get your GitHub Enterprise instance installed and on a virtualization platform of your choice
- [Provisioning and installation](https://help.github.com/enterprise/admin/guides/installation/provisioning-and-installation/)
## 🔧 Get Configured *
Get your GitHub Enterprise instance configured with the right authentication and backup infrastructure for your environment
- [Web-based management console](https://help.github.com/enterprise/admin/guides/installation/web-based-management-console/)
- [Authenticating users for your GitHub Enterprise instance](https://help.github.com/enterprise/admin/guides/user-management/authenticating-users-for-your-github-enterprise-instance/)
- [High Availability configuration](https://help.github.com/enterprise/admin/guides/installation/high-availability-configuration/)
- [Backups and disaster recovery](https://help.github.com/enterprise/admin/guides/installation/backups-and-disaster-recovery/)
- [Using GHE with a load balancer](https://help.github.com/enterprise/admin/guides/installation/using-github-enterprise-with-a-load-balancer/)
- [About Geo-replication](https://help.github.com/enterprise/admin/guides/installation/about-geo-replication/)
- Recommended architecture:
## 📁 Get Organized
Get your people and code organized to optimize discoverability and reuse
- [Organizing People for Successful Collaboration](https://vimeo.com/179075921/a774e76f4f) (5 min video)
- [Collaborating with groups in **organizations**](https://help.github.com/articles/collaborating-with-groups-in-organizations/)
- [Organizing members into **teams**](https://help.github.com/articles/organizing-members-into-teams/)
- [Creating **repositories**](https://help.github.com/articles/creating-a-repository-on-github/)
- e.g. @ [GitHub Desktop](https://github.com/desktop)
- Why organization structure matters
- The immediate instinct may be to create an organization for every project or department at your company, leading to many divided groups that function in GitHub as siloes
- This may seem like a good way to manage permissions and reduce noise, but it’s not always the ideal strategy
- In fact, it is detrimental to cross-team collaboration and can result in administrative headaches down the line
- Instead of creating many organizations and siloing users, we suggest using one or few organizations for shared ownership of repositories and making use of teams to segment users within those organizations -- e.g.: [Google](https://github.com/google); [Microsoft](https://github.com/Microsoft)
## :key: Get Access
Get access and permissions in place to satisfy your security policies
- [Permission levels for an organization](https://help.github.com/articles/permission-levels-for-an-organization/)
- [Repository permission levels for an organization](https://help.github.com/articles/repository-permission-levels-for-an-organization/)
- [Permission levels for a user account repository](https://help.github.com/articles/permission-levels-for-a-user-account-repository/)
- [Administering a repository](https://help.github.com/categories/administering-a-repository/)
- [About protected branches](https://help.github.com/articles/about-protected-branches/)
- [About required status checks](https://help.github.com/articles/about-required-status-checks/)
- [About branch restrictions](https://help.github.com/articles/about-branch-restrictions/)
## :nut_and_bolt: Get Setup
Get Git and GitHub setup for the first time
- [Git and GitHub Setup](https://help.github.com/categories/setup/)
- [Connecting to GitHub with SSH](https://help.github.com/articles/connecting-to-github-with-ssh/)
- [GitHub Desktop](https://desktop.github.com/): Extend your GitHub workflow beyond your browser
- [Atom](https://atom.io/): A customizable text editor
- [GitHub for Atom](https://github.atom.io/): Git and GitHub integration inside Atom
## 🌊 Get Flowing
Get your work flowing to the right people and reviewed by the right people
- [Understanding the GitHub Flow](https://guides.github.com/introduction/flow/)
- [About branches](https://help.github.com/articles/about-branches/)
- [About commits](https://help.github.com/categories/commits/)
- [About pull requests](https://help.github.com/articles/about-pull-requests/)
- [About pull request reviews](https://help.github.com/articles/about-pull-request-reviews/)
- [About pull request merges](https://help.github.com/articles/about-pull-request-merges/)
- [Mentioning users and teams](https://help.github.com/articles/basic-writing-and-formatting-syntax/#mentioning-users-and-teams)
- e.g. @ [Electron](https://github.com/electron/electron/pull/11658)
## ✅ Get Managing
Get your work and projects managed from start to finish
- Describing and discussing work:
- [Managing your work with issues](https://help.github.com/articles/managing-your-work-with-issues/)
- [Labeling issues and pull requests](https://help.github.com/articles/labeling-issues-and-pull-requests/)
- [Finding information in a repository](https://help.github.com/articles/finding-information-in-a-repository/)
- e.g. @ [Atom](https://github.com/atom/atom/issues)
- Planning and tracking work:
- [Tracking progress with project boards](https://help.github.com/articles/tracking-the-progress-of-your-work-with-project-boards/)
- [Tracking progress with milestones](https://help.github.com/articles/tracking-the-progress-of-your-work-with-milestones/)
- [Releases](https://help.github.com/categories/releases/)
- e.g. @ [Kubernetes](https://github.com/kubernetes/kubernetes/projects)
## :books: Get Documented
Get information about your work and projects documented to share right next to your code
- [READMEs](https://help.github.com/articles/about-readmes/) -- e.g. : [Spotify](https://github.com/spotify/luigi/blob/master/README.rst) ; [Docker](https://github.com/docker/docker.github.io/blob/master/README.md)
- [Wikis](https://help.github.com/categories/wiki/) -- e.g. : [D3](https://github.com/d3/d3/wiki) ; [Netflix Hystrix](https://github.com/Netflix/Hystrix/wiki) ; [Projects with great wikis](https://github.com/showcases/projects-with-great-wikis)
- [GitHub Pages](https://help.github.com/categories/github-pages-basics/) -- e.g. : [Facebook React Native](https://facebook.github.io/react-native/) ; [Twitter](http://twitter.github.io/) ; [Best Buy](https://bestbuyapis.github.io/api-documentation/) ; [GitHub Pages examples](https://github.com/showcases/github-pages-examples)
## 🔗 Get Integrated
Get integrated with the rest of your development pipeline
- [Products that integrate with the GitHub platform](https://github.com/works-with)
- [GitHub Services Integration](https://github.com/github/github-services)
- [GitHub Marketplace](https://github.com/marketplace)
- [GitHub API](https://developer.github.com/)
## 📢 Get Informed
Get informed on what's new with GitHub
- [GitHub Blog](https://github.com/blog/)
- [GitHub Engineering](https://githubengineering.com/)
- [The State of the Octoverse](https://octoverse.github.com/)
- [@github on Twitter](https://twitter.com/github)
## ⬆️ Get Upgraded *
Get your GitHub Enterprise instance upgraded to the latest release
- [Upgrading GitHub Enterprise](https://help.github.com/enterprise/admin/guides/installation/upgrading-github-enterprise/)
- [GitHub Enterprise Releases](https://enterprise.github.com/releases)
## ℹ️ Get Enabled
Get enabled on the basics of Git and GitHub
- [GitHub Learning Lab](https://lab.github.com/)
- [Git and GitHub learning resources](https://help.github.com/articles/git-and-github-learning-resources/)
- [On Demand Training](https://services.github.com/on-demand/) : [GitHub Learning Resources](https://services.github.com/on-demand/resources/) ; [Learning Path](https://services.github.com/on-demand/resources/learning-path/)
- [GitHub Guides @ YouTube](https://www.youtube.com/user/GitHubGuides) : [Git Basics • Training](https://www.youtube.com/playlist?list=PLg7s6cbtAD165JTRsXh8ofwRw0PqUnkVH) ; [Git and GitHub with Briana Swift](https://www.youtube.com/playlist?list=PLg7s6cbtAD17Gw5u8644bgKhgRLiJXdX4) (videos)
## 🆘 Get Help
Get dedicated help from GitHub to support your continued success
- [GitHub Success Team](sales@github.com) | [GitHub Professional Services](https://services.github.com/)
- [GitHub.com Support](https://github.com/support) | [GitHub Enterprise Support](https://enterprise.github.com/support)
Get help from the GitHub community
- [GitHub Community Forum](https://github.community/) | [GitHub Platform Forum](https://platform.github.community/)
## 🌐 Get Open Sourcing
Get collaborating with the Open Source community
- [The largest open source community in the world](https://github.com/open-source)
- [Open Source Guides](https://opensource.guide/)
- [Explore GitHub](https://github.com/explore)
- [Open source organizations](https://github.com/showcases/open-source-organizations) -- e.g.:
- [Open Source at Microsoft](https://opensource.microsoft.com/) : [TypeScript](https://github.com/Microsoft/TypeScript) ; [Azure Docs](https://github.com/MicrosoftDocs/azure-docs)
- [Capital One Open Source](https://developer.capitalone.com/open-source/)
- [Develop with Deere](https://developer.deere.com/)
- [Walmart Labs](http://walmartlabs.com/)
- [Spotify](https://spotify.github.io/)
- [Mapbox](https://github.com/mapbox)