diff --git a/lang/en/docs/cli/version.md b/lang/en/docs/cli/version.md
index eefb28e33..ce0009ead 100644
--- a/lang/en/docs/cli/version.md
+++ b/lang/en/docs/cli/version.md
@@ -23,10 +23,10 @@ For example, starting with this package.json `package.json`:
 }
 ```
 
-When we run the `yarn version` command:
+When we run the `yarn version --patch` command:
 
 ```sh
-yarn version
+yarn version --patch
 ```
 
 ```
@@ -46,9 +46,6 @@ We will get this updated `package.json`:
 }
 ```
 
-> **Note:** The new version you enter must be a valid
-> [SemVer]({{url_base}}/docs/dependency-versions#toc-semantic-versioning)
-> version.
 
 #### Git tags <a class="toc" id="toc-git-tags" href="#toc-git-tags"></a>
 
@@ -146,6 +143,10 @@ version.
 
 Creates a new version specified by `<version>`.
 
+> **Note:** The `<version>` you enter must be a valid
+> [SemVer]({{url_base}}/docs/dependency-versions#toc-semantic-versioning)
+> version.
+
 ##### `yarn version --major` <a class="toc" id="toc-yarn-version-major" href="#toc-yarn-version-major"></a>
 
 ##### `yarn version --minor` <a class="toc" id="toc-yarn-version-minor" href="#toc-yarn-version-minor"></a>