doc for wpcli-dev utility

docs/en-US/references/wpcli.md

@@ -0,0 +1,47 @@
+---
+category: 6. Reference
+order: 2
+title: WP-CLI
+permalink: /docs/en-US/references/wp-cli/
+---
+
+[WP-CLI](https://wp-cli.org/) is the command-line interface for WordPress. You can update plugins, configure multisite installations and much more, without using a web browser. 
+
+With this tool is possible to manage the websites installed, like changing the password of the users or export the database. This tool is used inside VVV from the default provisioners and internals and is very powerful.
+
+VVV includes the nightly version of WP-CLI, but if you want to contribute to WP CLI development, you can install the `wpcli-dev utility.
+
+## Examples
+
+```
+wp db import ~/db-export.sql # VVV automatically generated database bbackups on halt
+wp search-replace http://olddomain.com https://newdomain.com --export=newdb.sql --all-tables # Generate a dump with the url replaced
+wp media regenerate # Regenerate all the thumbnails and the various images
+wp post generate --count=10 # Create posts with dummy content
+```
+
+## Contribute to WP-CLI
+
+VVV include an utility to install the official dev environment with all the various repo from [https://github.com/wp-cli/wp-cli-dev/](https://github.com/wp-cli/wp-cli-dev/). To use this new instance replace `wp` with `wp-dev`.
+
+Right now to use this, SSH into the virtual machine using `vagrant ssh`.
+
+From the WP-CLI dev folder it is possible to run the unit tests of the various commands:
+
+![Unit test](https://user-images.githubusercontent.com/403283/66570851-b2c9a480-eb6e-11e9-8b8b-5242f687c07f.png)
+
+```
+composer behat # all the unit tests of a command
+composer behat -- ./features/yourtest.feature # for a specific test
+```
+
+WP-CLI has exhaustive [documentation](https://make.wordpress.org/cli/handbook/) on about [how to contribute](https://make.wordpress.org/cli/handbook/contributing/).
+
+We recommend adding a new git remote to the repository, so that you can push changes to GitHub for pull requests.
+
+## Resources
+
+There are already a lot of guides about WP CLI:
+
+  * [What you can do with WP-CLI (talk)](http://mte90.tech/Talk-WPCLI/)
+  * [Shell friends](https://make.wordpress.org/cli/handbook/shell-friends/)

docs/en-US/utilities.md

@@ -20,6 +20,8 @@ utilities:
     - tls-ca # SSL/TLS certificates
     - mongodb # needed for Tideways/XHGui
     - tideways # PHP profiling tool, also installs xhgui
+    - wpcli-dev # Install a dev environment to use and contribute to WP-CLI
+    - php # Install all the php utilities available automatically
     #- php56
     #- php70
     #- php71