From 3747bf73e85c04ff053df4eeec1a464798ffeb25 Mon Sep 17 00:00:00 2001
From: val <44687278+valeriaconde@users.noreply.github.com>
Date: Mon, 31 Oct 2022 11:20:46 -0700
Subject: [PATCH] =?UTF-8?q?[docs]=20document=20'version'=20command=20?=
 =?UTF-8?q?=F0=9F=93=83=E2=9A=A1=F0=9F=9A=80=20(#27509)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* document version command

* fixed a format mistake in common-options.md why not

* Fixed some wording
---
 docs/commands/common-options.md |  2 +-
 docs/commands/version.md        | 25 +++++++++++++++++++++++++
 2 files changed, 26 insertions(+), 1 deletion(-)
 create mode 100644 docs/commands/version.md

diff --git a/docs/commands/common-options.md b/docs/commands/common-options.md
index c58fb984fd..43460af526 100644
--- a/docs/commands/common-options.md
+++ b/docs/commands/common-options.md
@@ -60,7 +60,7 @@ In [Manifest Mode](../users/manifests.md), defaults to `vcpkg_installed/` under
 
 <a name="manifest-root"></a>
 
-### `--x-manifest-root=<path>`
+## `--x-manifest-root=<path>`
 
 **Experimental: will change or be removed at any time**
 
diff --git a/docs/commands/version.md b/docs/commands/version.md
new file mode 100644
index 0000000000..4c4df15418
--- /dev/null
+++ b/docs/commands/version.md
@@ -0,0 +1,25 @@
+# vcpkg version
+
+**The latest version of this documentation is available on [GitHub](https://github.com/Microsoft/vcpkg/tree/master/docs/commands/version.md).**
+
+## Synopsis
+
+```no-highlight
+vcpkg version
+```
+
+## Description
+
+Displays the version of the vcpkg executable.
+
+## Example
+```no-highlight
+$ vcpkg version
+vcpkg package management program version 2022-09-01-dfb82802c8cc562ce3b665a904a65b22314de724
+
+See LICENSE.txt for license information.
+```
+
+## Options
+
+All vcpkg commands support a set of [common options](common-options.md).