Update readme

README.md

@@ -1,5 +1,31 @@
 # Morpho Blue
 
+Morpho Blue is a new lending primitive that offers better rates, high capital efficiency and extended flexibility to lenders & borrowers.
+
+## Whitepaper
+
+A more detailed description of Morpho Blue can be found in the [Morpho Blue's Whitepaper](./whitepaper.pdf).
+
+## Repository Structure
+
+Morpho Blue is a singleton contract at the `src`'s root: [`Morpho.sol`](./src/Morpho.sol). It solely relies on internal libraries in the [`src/libraries`](./src/libraries) directory. No external dependency is used.
+
+Libaries in the [`src/libraries/periphery`](./src/libraries/periphery) directory are not directly used by Morpho Blue. They are useful helpers that integrators can reuse or adapt to their own needs.
+
+The `mocks` directory contains contracts designed exclusively for testing.
+
+You'll find relevant comments in [Morpho's interface](./src/interfaces/IMorpho.sol), notably a list of assumptions about market creation.
+
+## Getting Started
+
+Install dependencies with `yarn`.
+
+Run tests using forge: `yarn test:forge`
+
+Run tests using hardhat (gas cost study): `yarn test:hardhat`
+
+You will find other CLI commands in the [`package.json`](./package.json) file.
+
 ## Audits
 
 All audits are stored in the [audits](./audits/)' folder.