rome · ematipico · Jun 24, 2023 · Jun 24, 2023 · Jun 24, 2023
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -17,26 +17,3 @@
 ## Test Plan
 
 <!-- Demonstrate the code is solid. Example: The exact commands you ran and their output. -->
-
-## Changelog
-
-<!--
-Read the following paragraph for more information: https://github.com/rome/tools/blob/main/CONTRIBUTING.md#changelog
-
-Tick the checkbox if your PR requires a new line in the changelog.
--->
-
-- [ ] The PR requires a changelog line
-
-## Documentation
-
-<!--
-
-Read the following paragraph for more information: https://github.com/rome/tools/blob/main/CONTRIBUTING.md#documentation
-
-Tick the checkboxes if your PR requires some documentation, and if you will follow up with that
-
--->
-
-- [ ] The PR requires documentation
-- [ ] I will create a new PR to update the documentation
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -234,7 +234,7 @@ Please use the template provided.
 
 #### Changelog
 
-If the PR you're about to open is a bugfix/feature around Rome, you should add a new line to the `CHANGELOG.md`.
+If the PR you're about to open is a bugfix/feature around Rome, you can add a new line to the `CHANGELOG.md`, but it's not mandatory.
 
 At the top of the file you will see a `[Unreleased]` section. The headings divide the sections by "feature", make sure
 to add a new bullet point.
@@ -273,16 +273,7 @@ how the new formatting changes, and so on.
 #### Documentation
 
 If your PR requires some update on the website (new features, breaking changes, etc.), you should create a new PR once the previous PR is successfully merged.
-
-Go to the issues section and check the pinned issues.
-You will find a _**pinned issue**_ that starts with "Documentation and Focus". Inside, you will find the details of:
-- the name of the branch where to point the PR that updates the documentation;
-- the PR that we will merge when the release is ready;
-
-If you can't create a new PR, please let the team know.
-The template should help to give all the information to the team.
-
-Here are some other scripts that you might find useful.
+When adding new features, the documentation should be part of a new PR, which will be merged right before the release.
 
 #### Magic comments
 

diff --git a/editors/vscode/README.md b/editors/vscode/README.md
@@ -96,3 +96,10 @@ Enables Rome to handle renames in the workspace (experimental).
 
 Disables formatting, linting, and syntax errors for projects without a `rome.json` file. Requires Rome 12 or newer.
 Enabled by default.
+
+## Versioning
+
+We follow the specs suggested by [the official documentation](https://code.visualstudio.com/api/working-with-extensions/publishing-extension#prerelease-extensions):
+
+Odd minor versions are dedicated to pre-releases, e.g. `*.5.*` .
+Even minor versions are dedicated to official releases, e.g. `*.6.*`.
diff --git a/website/src/pages/vscode.mdx b/website/src/pages/vscode.mdx
@@ -102,3 +102,10 @@ Enables Rome to handle renames in the workspace (experimental).
 
 Disables formatting, linting, and syntax errors for projects without a `rome.json` file. Requires Rome 12 or newer.
 Enabled by default.
+
+## Versioning
+
+We follow the specs suggested by [the official documentation](https://code.visualstudio.com/api/working-with-extensions/publishing-extension#prerelease-extensions):
+
+Odd minor versions are dedicated to pre-releases, e.g. `*.5.*` .
+Even minor versions are dedicated to official releases, e.g. `*.6.*`.