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?
Creating a new Issue puts a problem on our radar!
See if your issue has already been reported, and if not, create a new one.
Could something be better? Want to share an idea with us?
Discussions are threads where you can offer feedback on things that might not exactly be problems to be fixed but are ideas to be explored.
Join the Docs Discussions where we brainstorm, ask questions, share hopes and dreams...
If you can see what the problem is, and you know how to fix it, then you can make a PR (pull request) with the change and contribute to the docs repo yourself!
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 and approved by a maintainer.
Important Note re: Internationalization (i18n)
Please only add new text content to the docs in English, only modifying .md files located within src/pages/en/.
We have automated systems in place for notifying our community translators that there is new material to be translated, so there is no need to make changes to additional languages yourself.
Speak another language natively? Join our i18n gang on Discord or jump into the PRs to help with translating or reviewing translations!
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/partial-hydration-typo-fixThat’s it. As you open a pull request, please include a clear title. The description will be pre-filled with questions that you can answer by editing right in the text field.
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.