/docs

Astro documentation

Primary LanguageAstroMIT LicenseMIT

Astro Docs Astro logo

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.

We are Astro

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 are Awesome

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.

Chat with Us

You can learn more about Astro, get support, and meet other devs in our Discord community.

Raise an Issue

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.

Edit a Page

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.

Develop

To begin developing locally, checkout this project from your machine.

git clone git@github.com:withastro/docs.git

You 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 start

If you’re copying these instructions, remember to configure this project as a fork.

git remote add upstream git@github.com:csstools/docs.git

At any point, create a branch for your contribution. We are not strict about branch names.

git checkout -b add/klingon-language

That’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.

Deploy

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.

Next Steps