X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=.github%2FCONTRIBUTING.md;h=d5599206751a2ff5fd7626f8cc78c7907c547a69;hb=8668796106b856ca041512af27268ce6e49d2caf;hp=ffb29f9eb249282c351dfd461f2a5b8edc5a5adf;hpb=c665b863c7c15c1928d63b55b13e3abd5790082e;p=github%2Fwallabag%2Fwallabag.git

diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index ffb29f9e..d5599206 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -1,30 +1,43 @@
 # How to contribute
 
-## You found a bug
-Please [open a new issue](https://github.com/wallabag/wallabag/issues/new).
+## Test it locally
+
+### Using Docker
+
+- Clone the repository
+- Ensure your Docker daemon is running
+- Launch `docker-compose up`
+
+You'll then have:
+- a web server (nginx)
+- a PHP daemon (using FPM)
+- a Redis database (to handle imports)
+- a SQLite database to store articles
+
+You can now access your wallabag instance using that url: `http://127.0.0.1:8000`
 
-To fix the bug quickly, we need some infos:
-* your wallabag version (on top of the ./index.php file, and also on config page)
-* your webserver installation :
-  * type of hosting (shared or dedicated)
-  * in case of a dedicated server, the server and OS used
-  * the php version used, eventually `phpinfo()`
-* which storage system you choose at install (SQLite, MySQL/MariaDB or PostgreSQL)
-* any problem on the `wallabag_compatibility_test.php` page
-* any particular details which could be related
+If you want to test using an other database than SQLite, uncomment the `postgres` or `mariadb` code from the `docker-compose.yml` file at the root of the repo. Also uncomment related line in the `php` section so the database will be linked to your PHP instance.
 
+### Using your own PHP server
 
-If relevant :
-* the link you want to save and which causes problem
-* the file you want to import into wallabag, or just an extract
+- Ensure you are running PHP > 7.1.
+- Clone the repository
+- Launch `composer install`
+- If you got some errors, fix them (they might be related to some missing PHP extension from your machine)
+- Then `php bin/console wallabag:install`
+- If you got some errors, fix them (they might be related to some missing PHP extension from your machine)
+- Run `php bin/console server:run`
 
-If you have the skills :
-* enable DEBUG mode and look the output at cache/log.txt
-* look for errors into php and server logs
+You can now access your wallabag instance using that url: `http://127.0.0.1:8000`
+
+## You found a bug
+Please [open a new issue](https://github.com/wallabag/wallabag/issues/new).
+
+To fix the bug quickly, we need some infos: please answer to the questions in the issue form.
+
+If you have the skills, look for errors into PHP, server and application logs (see `var/logs`).
 
 Note : If you have large portions of text, use [Github's Gist service](https://gist.github.com/) or other pastebin-like.
 
 ## You want to fix a bug or to add a feature
-Please fork wallabag and work with **the dev branch** only. **Do not work on master branch**.
-
-[Don't forget to read our guidelines](https://github.com/wallabag/wallabag/blob/dev/GUIDELINES.md).
+Please fork wallabag and work with **the master branch**.