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