From 6c352094637f4908ab25b677a1ec2f78cbea170e Mon Sep 17 00:00:00 2001
From: Luca Tumedei <luca@theaveragedev.com>
Date: Sun, 18 Feb 2024 11:23:59 +0100
Subject: [PATCH] docd(mkdocs.yml) udpate toc, rename migration

---
 README.md          |  2 ++
 docs/commands.md   |  2 ++
 docs/extensions.md |  2 ++
 docs/migration.md  |  8 ++++++++
 mkdocs.yml         | 12 +++++++++++-
 5 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a2cc64d87..c6771daca 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 You can use wp-browser to test WordPress sites, plugins and themes.
 
+An easy and quick setup, with a default configuration that will work for most projects, run end-to-end tests, integration tests and unit tests all wit the same tool.
+
 ## Requirements
 
 Depending on the nature of your project, there are different requirements it will need to satisfy before getting started.
diff --git a/docs/commands.md b/docs/commands.md
index 56d367b6e..e969b3674 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -332,6 +332,8 @@ extensions:
 
 Clear the monkey-patching cache.
 
+Use the `--porcelain` or `-p` option to suppress any confirmation output.
+
 [1]: https://wp-cli.org/
 
 [2]: https://github.com/WordPress/wordpress-develop/tree/trunk/tests/phpunit
diff --git a/docs/extensions.md b/docs/extensions.md
index 9be131b48..df3b2675c 100644
--- a/docs/extensions.md
+++ b/docs/extensions.md
@@ -160,6 +160,8 @@ extensions:
 In your tests, you can use the annotations or attributes as you would in a PHPUnit test:
 
 ```php
+<?php
+
 use lucatume\WPBrowser\TestCase\WPTestCase;
 
 class IsolationExampleTest extends WPTestCase {
diff --git a/docs/migration.md b/docs/migration.md
index 0cabc078f..6f9b5ed4c 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -57,6 +57,8 @@ back-compatibility purposes.
 2. If your test code is loading deprecated functions, arguments, classes, files, or hooks, you need to update your test
    code to let the test case know using the `setExpectedDeprecated` method:
     ```php
+    <?php
+   
     use lucatume\WPBrowser\TestCase\WPTestCase;
    
     class MyTestUsingDeprecatedCode extends WPTestCase {
@@ -90,6 +92,8 @@ back-compatibility purposes.
 
 3. If your test code is directly modifying properties like `$expected_deprecated` or `$expected_doing_it_wrong` directly, you need to update your test code to use the `setExpectedDeprecated` and `setExpectedIncorrectUsage` methods:
     ```php
+    <?php
+   
     use lucatume\WPBrowser\TestCase\WPTestCase;
     class MyTestUsingDeprecatedCode extends WPTestCase {
         public function test_deprecated_function() {
@@ -109,6 +113,8 @@ back-compatibility purposes.
 4. If your test code is knowingly triggering doing-it-wrong notices, you need to update your test code to let the test
    case know using the `setExpectedIncorrectUsage` method:
     ```php
+    <?php
+   
     use lucatume\WPBrowser\TestCase\WPTestCase;
     class MyTestUsingDoingItWrongTest extends WPTestCase {
         public function test_it_can_use_doing_it_wrong() {
@@ -122,6 +128,8 @@ back-compatibility purposes.
 
 5. Some assertion methods have, in more recent versions of the PHPUnit core suite, adopted stricter type checks when it comes to comparison. E.g., the `assertEqualFields` will now check the object to check the fields on is actually an object. Depending on how loose your use of assertions was before, you might have to update your work to make it pass the stricter checks:
    ```php
+   <?php
+   
    use lucatume\WPBrowser\TestCase\WPTestCase;
    
     class MyTestUsingAssertEqualFields extends WPTestCase {
diff --git a/mkdocs.yml b/mkdocs.yml
index 1ce819f66..765781ed1 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -10,7 +10,7 @@ site_description: 'Documentation for the wp-browser WordPress testing framework.
 site_author: 'Luca Tumedei'
 nav:
   - Getting started: 'README.md'
-  - Migrating to version 4: 'migration.md'
+  - Migrating to newer versions: 'migration.md'
   - Default configuration: 'default-configuration.md'
   - Custom configuration: 'custom-configuration.md'
   - Modules:
@@ -25,6 +25,7 @@ nav:
       - PHP Built-in Server Controller: 'extensions#builtinservercontroller'
       - ChromeDriver Controller: 'extensions#chromedrivercontroller'
       - Docker Compose Controller: 'extensions#dockercomposecontroller'
+      - Isolation Support: 'extensions#isolationsupport'
   - Commands:
       - run and codeception:run: 'commands#run-and-codeceptionrun'
       - dev:start: 'commands#devstart'
@@ -34,6 +35,15 @@ nav:
       - wp:db:export: 'commands#wpdbexport'
       - chromedriver:update: 'commands#chromedriverupdate'
       - generate:wpunit: 'commands#generatewpunit'
+      - generate:wpajax: 'commands#generatewpajax'
+      - generate:wpcanonical: 'commands#generatewpcanonical'
+      - generate:wprestapi: 'commands#generatewprestapi'
+      - generate:wprestcontroller: 'commands#generatewprestcontroller'
+      - generate:wprestposttypecontroller: 'commands#generatewprestposttypecontroller'
+      - generate:wpxml: 'commands#generatewpxml'
+      - generate:wpxmlrpc: 'commands#generatewpxmlrpc'
+      - monkey:cache:path: 'commands#monkeycachepath'
+      - monkey:cache:clear: 'commands#monkeycacheclear'
   - Troubleshooting: 'troubleshooting.md'
   - Sponsorship: 'https://github.com/sponsors/lucatume'
   - Changelog: 'https://github.com/lucatume/wp-browser/blob/master/CHANGELOG.md'