diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index cb5c9e78..1d79ec44 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -17,5 +17,6 @@ Add any other context about your changes here.
 - [ ] Mention any [related issues](https://github.com/premake/premake-core/issues) (put `closes #XXXX` in comment to auto-close issue when PR is merged)
 - [ ] Follow our [coding conventions](https://github.com/premake/premake-core/blob/master/CONTRIBUTING.md#coding-conventions)
 - [ ] Minimize the number of commits
+- [ ] Align [documentation](https://github.com/premake/premake-core/tree/master/website) to your changes
 
 *You can now [support Premake on our OpenCollective](https://opencollective.com/premake). Your contributions help us spend more time responding to requests like these!*
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e5edf056..ad1c82cc 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -73,6 +73,8 @@ Some tips...
 
 - Write tests! You don't need to go crazy, but we will expect a unit test or two to show that your fix or feature does what it says, and doesn't break in the future. There are many test examples in Premake's source code, covering both the [modules](https://github.com/premake/premake-core/tree/master/modules) and the [core](https://github.com/premake/premake-core/tree/master/tests). Feel free to copy!
 
+- Align [documentation](https://github.com/premake/premake-core/tree/master/website) to your changes. Keeping docs up to date is very important for all users of Premake.
+
 - When you submit a change, try to limit the number of commits involved. A single commit is ideal.
 
 - Follow our coding conventions, which we've intentionally kept quite minimal.
diff --git a/website/README.md b/website/README.md
index 3ae78ad4..e59facb2 100644
--- a/website/README.md
+++ b/website/README.md
@@ -2,6 +2,16 @@
 
 Premake website is built using [Docusaurus 2](https://v2.docusaurus.io/), a modern static website generator.
 
+All docs pages can be found in the `docs/` folder.
+
+## Adding a new entry to the docs
+Editing our documentation website is very simple. You don't have to build a whole website for this. All pages are stored in Markdown files, so in order to add a new entry:
+
+1. Add a new Markdown file into the `docs/` folder. Follow naming conventions there.
+2. Add your Markdown file's name into the `sidebars.js`. Make sure you've kept alphabetical order among category items.
+
+*Use other files as references.*
+
 ## Installation
 
 ```