[docs] documenting list command 📃❤✨ (#27617)

* added list.md :)

* fixed formatting

* somehow these weird tabs make the file render correctly

* format

* dont mind me fighting with the formatting

* Suggested changes

* added missing commands from docs readme

docs/README.md

@@ -21,8 +21,11 @@ Vcpkg helps you manage C and C++ libraries on Windows, Linux and MacOS. This too
 - Commands
   - [vcpkg install](commands/install.md)
   - [vcpkg integrate](commands/integrate.md)
+  - [vcpkg list](commands/list.md)
   - [vcpkg remove](commands/remove.md)
   - [vcpkg search](commands/search.md)
+  - [vcpkg update-baseline](commands/update-baseline.md)
+  - [vcpkg version](commands/version.md)
 
 ### User Help
 

docs/commands/list.md

@@ -0,0 +1,31 @@
+# vcpkg list
+
+**The latest version of this documentation is available on [GitHub](https://github.com/Microsoft/vcpkg/tree/master/docs/commands/list.md).**
+
+## Synopsis
+
+```no-highlight
+vcpkg list [options]
+```
+
+## Description
+
+Shows a list of the packages in the installed tree, along with the version and description of each. 
+
+## Example
+```no-highlight
+$ vcpkg list
+
+cxxopts:x64-windows				3.0.0			This is a lightweight C++ option parser library...
+fmt:x64-windows					9.0.0			Formatting library for C++. It can be used as a...
+range-v3:x64-windows				0.12.0 			Range library for C++11/14/17/20.
+vcpkg-cmake-config:x64-windows			2022-02-06#1
+vcpkg-cmake:x64-windows				2022-08-18
+```
+
+## Options
+
+All vcpkg commands support a set of [common options](https://github.com/microsoft/vcpkg/blob/5fac018507e67a8b98141b9d4cebeb07c9bd5cba/docs/commands/common-options.md).
+
+### `--x-full-desc`
+Print the full, untruncated description of each package.