To all who come to this happy place: welcome.
This is the repo for docs.astro.build. This repo contains all the source code we use to build our docs site.
Astro is a site builder for the web platform. We want everyone to be successful building sites, and that means helping everyone understand how Astro works.
You can also help make the docs awesome. Your feedback is welcome. Your writing, editing, translating, designing, and developing skills are welcome. You being a part of our community is welcome.
You can learn more about Astro, get support, and meet other devs in our Discord community.
Is something missing? Is something wrong? Could something be better? Issues are a quick way for you to offer us feedback about the docs.
Before you share, please see if your issue has already been reported.
Every page on docs.astro.build has an Edit this page button in the sidebar. You can click that button to edit the source code for that page in GitHub.
After you make your changes, click Commit changes. This will automatically create a fork of the docs in your GitHub account with the changes.
Once your edits are ready in GitHub, follow the prompts to create a pull request and submit your changes for review. Every pull request needs to be reviewed by our contributors.
Help us translate our content! Check out the dedicated i18n guide for more details.
To begin developing locally, checkout this project from your machine.
git clone git@github.com:withastro/docs.gitYou can install and run the project locally using pnpm. Head to the pnpm installation guide to get that set up. Then, run the following from your terminal:
pnpm install
pnpm startIf you’re copying these instructions, remember to configure this project as a fork.
git remote add upstream git@github.com:csstools/docs.gitAt any point, create a branch for your contribution. We are not strict about branch names.
git checkout -b add/klingon-languageThat’s it. As you open a pull request, please include a clear title and description.
# Add Klingon language to Getting Started page
This adds the Klingon language and also updates the sidebar and language selection components.Thank you for helping make the docs awesome. And please, come chat with us if you have any questions.
Every pull request generates a preview using Netlify for anyone to see.
Use the Deploy Preview of your pull request to review and share your changes.
The docs site will be automatically updated whenever pull requests are merged.