doc: readme update

Author: sarahcssiqueira

readme.md

@@ -19,6 +19,8 @@ This is a basic **Docker WordPress Environment** focused on the development of *
 - [Requirements](#requirements)
 - [Usage](#usage)
   - [Variables](#variables)
+  - [WordPress Debug](#debug)
+  - [Xdebug for VSCode](#xdebug)
 - [Contributing and Support](#contributing-and-support)
 
 ---
@@ -51,7 +53,9 @@ The **wpcli container** was added to only run one-off commands. Don’t need it
 
 ## Requirements
 
-- [Docker](https://www.docker.com/) hub installed.
+- [Docker](https://www.docker.com/) hub
+- [Xdebug](https://xdebug.org/docs/install)
+- [PHP Debug Extension](https://marketplace.visualstudio.com/items?itemName=xdebug.php-debug)
 
 ## Usage
 
@@ -75,4 +79,44 @@ Uses the official WordPress latest docker image.
 
 The **wpcli container** was added to only run one-off commands. Don’t need it to run as a service, only as a cli tool, for that run:
 
-`docker-compose run --rm wpcli command`
+For using wp-cli, use `docker-compose run --rm wpcli command` as it was added to only run one-off commands
+
+## Debugging in WordPress
+
+The wp-core is synchronized through the docker-composer.yml just in case you need to check and/or debug something. After running `docker-compose up -d`, you will be able to change the [WordPress debug mode](https://wordpress.org/documentation/article/debugging-in-wordpress/) by changing the following lines on the wp-config.php file.
+
+By default, the wp-config.php generated by Docker will look something like this:
+
+```
+define( 'WP_DEBUG', !!getenv_docker('WORDPRESS_DEBUG', '') );
+
+```
+
+Replace it with the following:
+
+```
+define( 'WP_DEBUG', true);
+
+define( 'WP_DEBUG_LOG' , true );
+
+define ( 'WP_DEBUG_DISPLAY', true );
+
+```
+
+More info about **debugging in WordPress** you can find [here](https://wordpress.org/documentation/article/debugging-in-wordpress/).
+
+## Xdebug for VSCode
+
+Xdebug is enabled and configured to work on VSCode using the extension PHP Debug.
+
+### Remote Host Debugging
+
+```
+"pathMappings": {
+  "/var/www/html": "${workspaceFolder}",
+}
+```
+
+# Contributing and Support
+
+It's **work in progress.** Feel free to contribute informing about [issues](https://github.com/sarahcssiqueira/docker-wordpress/issues) or even through [pull requests](https://github.com/sarahcssiqueira/docker-wordpress/pulls) for improvements.