Merge pull request #1907 from LibreSign/feature/improve-documentation

Update CONTRIBUTING.md

Author: vitormattos

CONTRIBUTING.md

@@ -1,27 +1,54 @@
 # How to contribute?
 
-Fork and pull request! 😃
+**Simple way**: Fork and pull request! 😃
 
-NOTE: If the project does not have an issue for what you want to do, create an issue first.
+**NOTE**: If the project does not have an issue for what you want to do, create an issue first.
 
 Feel free to submit [Github Issues](https://github.com/libresign/libresign/issues) or pull requests.
 
-The documentation website is build from the docs folder with vuepress.
+But... follow the complete way:
 
 ## To start front and backend development environment
 
-```bash
-make serve
-```
+* Start the Nextcloud development.
+  > **NOTE**: I suggest to use this: https://github.com/LibreCodeCoop/nextcloud-docker-development/ only because is the environment that I use 😅. I also suggest to use https://github.com/juliushaertl/nextcloud-docker-dev but the setup will be a bit different of this tutorial.
+* Wait to be possible access `localhost` in your browser
+* Inside the folder of nextcloud environment (the folder that contains the project of previous step), go to `volumes/nextloud/apps-extra` clone the LibreSign repository
+* open bash in nextcloud container with `docker compose exec -u www-data nextcloud bash`
+* Inside bash of Nextcloud, go to folder `apps-extra/libresign`
+* Run the commands:
+  ```bash
+  # download composer dependencies
+  composer install
+  # download JS dependencies
+  npm ci
+  # build and watch JS changes
+  npm run watch
+  ```
+* Now, access the `localhost` on your browser
 
 ## To update API documentation
 
 [Repository of site and API documentation](https://github.com/libresign/libresign.github.io)
 
-## To run PHPUnit
+## Executing tests
+### PHPUnit, Psalm, PHPCS,...
 
-```bash
-make test
-```
+* Run all tests inside `bash` of `nextcloud` service
 
 Read more in composer.json scripts section
+
+### Behat
+
+* Access bash of `nextcloud` service
+* Go to folder `tests/integration` of Libresign app
+* Install dependencies:
+  ```bash
+  composer i
+  ```
+* Run tests:
+  ```bash
+  vendor/bin/behat
+  ```
+
+You also can run a specific scenario