This repository contains the documentation website code and Markdown source files for docs.github.com.
GitHub's Docs team works on pre-production content in a private repo that regularly syncs with this public repo.
Use the table of contents icon on the top left corner of this document to get to a specific section of this guide quickly.
See the contributing guide for detailed instructions on how to get started with our project.
We accept different types of contributions, including some that don't require you to write a single line of code.
On the GitHub Docs site, you can click the make a contribution button to open a PR(Pull Request) for quick fixes like typos, updates, or link fixes.
For more complex contributions, you can open an issue using the most appropriate issue template to describe the changes you'd like to see. By this way you can also be a part of Open source contributor's community without even writing a single line of code.
If you're looking for a way to contribute, you can scan through our existing issues for something to work on. When ready, check out Getting Started with Contributing for detailed instructions.
We use GitHub Discussions to talk about all sorts of topics related to documentation and this site. For example: if you'd like help troubleshooting a PR, have a great new idea, or want to share something amazing you've learned in our docs, join us in the discussions.
If you're having trouble with your GitHub account, contact Support.
That's how you can easily become a member of the GitHub Documentation community. โจ
In addition to the README you're reading right now, this repo includes other READMEs that describe the purpose of each subdirectory in more detail: You can go through among them for specified details regarding the topics listed below.
- content/README.md
- content/graphql/README.md
- content/rest/README.md
- contributing/README.md
- data/README.md
- data/reusables/README.md
- data/variables/README.md
- includes/liquid-tags/README.md
- includes/README.md
- components/README.md
- lib/liquid-tags/README.md
- middleware/README.md
- script/README.md
- stylesheets/README.md
- tests/README.md
The GitHub product documentation in the assets, content, and data folders are licensed under a CC-BY license.
All other code in this repository is licensed under the MIT license.
When you are using the GitHub logos, be sure to follow the GitHub logo guidelines.
Thanks for all your contributions and efforts towards improving the GitHub documentation. We thank you being part of our โจ community โจ ! title: Quickstart for Codespaces intro: 'Try out {% data variables.product.prodname_codespaces %} in 5 minutes.' allowTitleToDifferFromFilename: true product: '{% data reusables.gated-features.codespaces %}' versions: fpt: '' ghec: '' type: quick_start topics:
- Codespaces redirect_from:
- /codespaces/codespaces-quickstart
In this guide, you'll create a codespace from a template repository and explore some of the essential features available to you within the codespace.
From this quickstart, you will learn how to create a codespace, connect to a forwarded port to view your running application, use version control in a codespace, and personalize your setup with extensions.
For more information on exactly how {% data variables.product.prodname_codespaces %} works, see the companion guide "Deep dive into {% data variables.product.prodname_codespaces %}."
-
Navigate to the template repository and select Use this template.
-
Name your repository, select your preferred privacy setting, and click Create repository from this template.
-
Navigate to the main page of the newly created repository. Under the repository name, use the {% octicon "code" aria-label="The code icon" %} Code drop-down menu, and in the Codespaces tab, click {% octicon "plus" aria-label="The plus icon" %} New codespace.
Once your codespace is created, your repository will be automatically cloned into it. Now you can run the application and launch it in a browser.
-
Since this example uses a Node.js project, start the application by entering
npm run dev
in the terminal. This command executes thedev
script in the package.json file and starts up the web application defined in the sample repository.If you're following along with a different application type, enter the corresponding start command for that project.
-
When your application starts, the codespace recognizes the port the application is running on and displays a prompt to forward that port so you can connect to it.
- Click Open in Browser to view your running application in a new tab.
-
Switch back to your codespace and open the
haikus.json
file by double-clicking it in the File Explorer. -
Edit the
text
field of the first haiku to personalize the application with your own haiku. -
Go back to the running application tab in your browser and refresh to see your changes.
{% octicon "light-bulb" aria-label="The lightbulb icon" %} If you've closed the tab, open the Ports panel and click the Open in browser icon for the running port.
Now that you've made a few changes, you can use the integrated terminal or the source view to commit and push the changes back to the remote.
{% data reusables.codespaces.source-control-display-dark %}
- To stage your changes, click + next to the file you've changed, or next to Changes if you've changed multiple files and you want to stage them all.
- Type a commit message describing the change you've made.
- To commit your staged changes, click the check mark at the top the source control side bar.
You can push the changes you've made. This applies those changes to the upstream branch on the remote repository. You might want to do this if you're not yet ready to create a pull request, or if you prefer to create a pull request on {% data variables.product.prodname_dotcom %}. - At the top of the side bar, click the ellipsis (...).
- In the drop-down menu, click Push.
Within a codespace, you have access to the Visual Studio Code Marketplace. For this example, you'll install an extension that alters the theme, but you can install any extension that is useful for your workflow.
-
In the left sidebar, click the Extensions icon.
-
In the search bar, enter
fairyfloss
and install the fairyfloss extension.
- Select the
fairyfloss
theme by selecting it from the list.
- Changes you make to your editor setup in the current codespace, such as theme and keyboard bindings, are synced automatically via Settings Sync to any other codespaces you open and any instances of Visual Studio Code that are signed into your GitHub account.
You've successfully created, personalized, and run your first application within a codespace but there's so much more to explore! Here are some helpful resources for taking your next steps with {% data variables.product.prodname_codespaces %}.
- Deep dive: This quickstart presented some of the features of {% data variables.product.prodname_codespaces %}. The deep dive looks at these areas from a technical standpoint.
- Setting up your project for {% data variables.product.prodname_codespaces %}: These guides provide information on setting up your project to use {% data variables.product.prodname_codespaces %} with specific languages
- Configuring {% data variables.product.prodname_codespaces %} for your project: This guide provides details on creating a custom configuration for {% data variables.product.prodname_codespaces %} for your project.