astro/smoke/docs-main/README.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

99 lines
3.3 KiB
Markdown
Raw Normal View History

# Astro Docs <img align="right" valign="center" height="52" width="39" src="https://raw.githubusercontent.com/withastro/astro/main/assets/brand/logo.svg" alt="Astro logo" />
To all who come to this happy place: welcome.
This is the repo for [docs.astro.build](https://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](https://astro.build/chat).
## 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](https://github.com/withastro/docs/issues).
## Edit a Page
Every page on [docs.astro.build](https://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](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks) 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.
```shell
git clone git@github.com:withastro/docs.git
```
You can install and run the project locally using your preferred package manager.
```shell
npm install
npm start
```
If youre copying these instructions, remember to [configure this project as a fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/configuring-a-remote-for-a-fork).
```shell
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.
```shell
git checkout -b add/klingon-language
```
Thats it.
As you [open a pull request](https://github.com/withastro/astro/compare), please include a clear title and description.
```markdown
# 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](https://astro.build/chat) 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
- [Read the docs](https://docs.astro.build/)
- [Fork the docs](https://github.com/withastro/docs/fork)
- [Raise an issue](https://github.com/withastro/docs/issues/new)
- [Discuss the docs](https://discord.gg/cZDZU3hJHc)