Page source content

The English content of our website is written in .mdx files located within src/content/docs/en/. Clicking “Edit this page” will take you directly to the file you need, but you can also navigate to any page file from the Astro docs repo and click the pencil icon to edit the file.

Please check the very top of the file as there may be additional instructions specific to that page! For example, the source content for that page may be generated in a different file and you should not make a change directly to this file.

CHANGING EXISTING DOCUMENTATION

All changes to the documentation (rewording existing documentation, adding new sections etc.) occur in English only, by modifying only .mdx files located within src/content/docs/en/. All new or changed content is approved in English first, and then is translated separately.

By default, when you edit an English page, our Translation Tracker updates every other language with a “needs updating” status. Normally, this is what we want! If an explanation has changed, or a code sample has been updated, then the other languages should make the appropriate change, too.

However, if your change is an English-only correction (e.g. a typo fix to an English word) that does not otherwise alter the documentation, then please be sure to title your pull request appropriately when you create a pull request.

Documentation for every other language is located in a separate folder within src/content/docs/. The page content of these documents is never generated from outside sources, and is always changed in these files. To fix a small error in these pages, use the same procedure as editing an English page. However, always keep the content an exact representation of the English docs. Do not revise wording or sections here, and only match the English content.

If editing a translated page makes you notice a problem with the current English documentation, or you would like to suggest an improvement, please file an issue and let us know! Our translators often spot things that could be better in our docs, and we appreciate the help!

See our i18n guide for translators for more information about translating the docs!

Pages generated from outside sources

Some of our English-language pages are generated from outside sources and maintained in another repo. Currently, these files are configuration-reference.md and all of our error messages.

The page’s Edit this page link should redirect you to the file that should be changed, even if it is not in the Astro docs repo itself. Alternatively, you can get the correct URL from the file’s githubURL frontmatter property.

Note

All of these English generated pages in the docs repo will have a dev-only warning at the top and the githubURLfrontmatter property. Please do look at the top of the file before you make changes and submit a pull request, as there are additional instructions there when necessary.

Translated pages are always edited directly in the docs repo.