Add documentation for installing WP-CLI packages

commands/package/install.md

@@ -20,6 +20,8 @@ When installing a .zip file, WP-CLI extracts the package to `~/.wp-cli/packages/
 If Github token authorization is required, a GitHub Personal Access Token (https://github.com/settings/tokens) can be used. The following command will add a GitHub Personal Access Token to Composer's global configuration:
 composer config -g github-oauth.github.com <GITHUB_TOKEN> Once this has been added, the value used for <GITHUB_TOKEN> will be used for future authorization requests.
 
+For more information about version constraints, see the [Package Version Constraints](https://make.wordpress.org/cli/handbook/guides/package-version-constraints/) guide.
+
 ### OPTIONS
 
 See the [argument syntax](https://make.wordpress.org/cli/handbook/references/argument-syntax/) reference for a detailed explanation of the syntax conventions used.

guides.md

@@ -8,5 +8,6 @@
 * **[External resources](https://make.wordpress.org/cli/handbook/guides/external-resources/)** - Blog posts, slides and videos from users.
 * **[Force output to a specific locale](https://make.wordpress.org/cli/handbook/guides/force-output-specific-locale/)** - Localisation issue
 * **[Identify a Plugin or Theme Conflict](https://make.wordpress.org/cli/handbook/guides/identify-plugin-theme-conflict/)** - Debugging advise
+* **[Package Version Constraints](https://make.wordpress.org/cli/handbook/guides/package-version-constraints/)** - Learn about version constraint syntax for packages
 * **[Sharing WP-CLI Packages](https://make.wordpress.org/cli/handbook/guides/sharing-wp-cli-packages/)** - Some words about your environment
 * **[Troubleshooting Guide](https://make.wordpress.org/cli/handbook/guides/troubleshooting/)** - Some help to troubleshoot

guides/package-version-constraints.md

@@ -0,0 +1,32 @@
+# Package Version Constraints
+
+When installing WP-CLI packages using the `wp package install` command, you can specify version constraints to control which version of a package is installed.
+
+Version constraints are specified by appending a colon (`:`) followed by the constraint to the package name:
+
+```bash
+wp package install <package-name>:<version-constraint>
+```
+
+## Common Constraints
+
+WP-CLI uses Composer's version constraint syntax. Here are some commonly used examples:
+
+```bash
+# Install a specific version
+wp package install wp-cli/server-command:2.0.0
+
+# Install with caret operator (allows non-breaking updates)
+wp package install wp-cli/server-command:^1.0
+
+# Install with tilde operator (allows patch-level updates)
+wp package install wp-cli/server-command:~1.2
+
+# Install the latest stable release
+wp package install wp-cli/server-command:@stable
+
+# Install from a development branch
+wp package install wp-cli/server-command:dev-main
+```
+
+For complete documentation on version constraint syntax and operators, see the [Composer documentation on versions and constraints](https://getcomposer.org/doc/articles/versions.md).