Update doc

README.md

@@ -1,2 +1,72 @@
-# debtPayment
+# IncomeVault
 Contracts to perform coupon payment
+
+## Initialization
+
+You must first initialize the submodules, with
+
+```
+forge install
+```
+
+See also the command's [documentation](https://book.getfoundry.sh/reference/forge/forge-install).
+
+Later you can update all the submodules with:
+
+```
+forge update
+```
+
+See also the command's [documentation](https://book.getfoundry.sh/reference/forge/forge-update).
+
+
+
+## Compilation
+
+The official documentation is available in the Foundry [website](https://book.getfoundry.sh/reference/forge/build-commands) 
+
+```
+ forge build --contracts src/RuleEngine.sol
+```
+
+```
+ forge build --contracts src/RuleWhiteList.sol
+```
+
+## Testing
+
+You can run the tests with
+
+```
+forge test
+```
+
+To run a specific test, use
+
+```
+forge test --match-contract <contract name> --match-test <function name>
+```
+
+See also the test framework's [official documentation](https://book.getfoundry.sh/forge/tests), and that of the [test commands](https://book.getfoundry.sh/reference/forge/test-commands).
+
+### Coverage
+
+* Perform a code coverage
+
+```
+forge coverage --ffi
+```
+
+* Generate LCOV report
+
+```
+forge coverage --report lcov
+```
+
+- Generate `index.html`
+
+```bash
+forge coverage --report lcov && genhtml lcov.info --branch-coverage --output-dir coverage
+```
+
+See [Solidity Coverage in VS Code with Foundry](https://mirror.xyz/devanon.eth/RrDvKPnlD-pmpuW7hQeR5wWdVjklrpOgPCOA-PJkWFU) &  [Foundry forge coverage](https://www.rareskills.io/post/foundry-forge-coverage)

doc/TOOLCHAIN.md

@@ -53,6 +53,10 @@ Warning:
 
 ## Generate documentation
 
+### Coverage
+
+
+
 ### [docgen](https://github.com/OpenZeppelin/solidity-docgen)
 
 >Solidity-docgen is a program that extracts documentation for a Solidity project.