Update readme

README.md

@@ -8,7 +8,7 @@
 > Expect rapid iteration.
 > **Do not use in production.**
 
-## Installation
+## Usage
 
 ### First time?
 
@@ -19,6 +19,111 @@ brew install gmp # mac
 ```
 > If you have any troubles installing gmp on your Apple M1 computer, [here’s a list of potential solutions](https://github.com/OpenZeppelin/nile/issues/22).
 
+### Set up the project
+
+Create a directory for your project, then `cd` into it and create a Python virtual environment.
+
+```bash
+mkdir my-project
+cd my-project
+python3 -m venv env
+source env/bin/activate
+```
+
+Install the [Nile](https://github.com/OpenZeppelin/nile) development environment and then run `init` to kickstart a new project. Nile will create the project directory structure and install [the Cairo language](https://www.cairo-lang.org/docs/quickstart.html), a [local network](https://github.com/Shard-Labs/starknet-devnet/), and a [testing framework](https://docs.pytest.org/en/6.2.x/).
+
+```bash
+pip install cairo-nile
+nile init
+```
+
+### Install the library
+
+```bash
+pip install openzeppelin-cairo-contracts
+```
+
+### Use a basic preset
+
+Presets are ready-to-use contracts that you can deploy right away. They also serve as examples of how to use library modules. [Read more about presets](docs/Extensibility.md#presets).
+
+```python
+# contracts/MyToken.cairo
+
+%lang starknet
+
+from openzeppelin.token.erc20.ERC20 import constructor
+```
+
+Compile and deploy it right away:
+```bash
+nile compile
+
+nile deploy MyToken <name> <symbol> <decimals> <initial_supply> <recipient> --alias my_token
+```
+
+> Note that `<initial_supply>` is expected to be two integers i.e. `1` `0`. See [Uint256](docs/Utilities.md#Uint256) for more information.
+
+### Write a custom contract using library modules
+[Read more about libraries](docs/Extensibility.md#libraries).
+
+```python
+%lang starknet
+
+from starkware.cairo.common.cairo_builtins import HashBuiltin
+from starkware.cairo.common.uint256 import Uint256
+from openzeppelin.security.pausable import Pausable_when_not_paused
+from openzeppelin.token.erc20.library import (
+    ERC20_name,
+    ERC20_symbol,
+    ERC20_totalSupply,
+    ERC20_decimals,
+    ERC20_balanceOf,
+    ERC20_allowance,
+
+    ERC20_initializer,
+    ERC20_approve,
+    ERC20_increaseAllowance,
+    ERC20_decreaseAllowance,
+    ERC20_transfer,
+    ERC20_transferFrom,
+    ERC20_mint
+)
+
+(...)
+
+@external
+func transfer{
+        syscall_ptr : felt*,
+        pedersen_ptr : HashBuiltin*,
+        range_check_ptr
+    }(recipient: felt, amount: Uint256) -> (success: felt):
+    Pausable_when_not_paused()
+    ERC20_transfer(recipient, amount)
+    return (TRUE)
+end
+```
+
+## Learn
+
+### Contract documentation
+* [Account](docs/Account.md)
+* [ERC20](docs/ERC20.md)
+* [ERC721](docs/ERC721.md)
+* [Contract extensibility pattern](docs/Extensibility.md)
+* [Proxies and upgrades](docs/Proxies.md)
+* [Utilities](docs/Utilities.md)
+### Cairo
+* [StarkNet official documentation](https://www.cairo-lang.org/docs/hello_starknet/index.html#hello-starknet)
+* [Cairo language documentation](https://www.cairo-lang.org/docs/hello_cairo/index.html#hello-cairo)
+* Perama's [Cairo by example](https://perama-v.github.io/cairo/by-example/)
+* [Cairo 101 workshops](https://www.youtube.com/playlist?list=PLcIyXLwiPilV5RBZj43AX1FY4FJMWHFTY)
+### Nile
+* [Getting started with StarkNet using Nile](https://medium.com/coinmonks/starknet-tutorial-for-beginners-using-nile-6af9c2270c15)
+* [How to manage smart contract deployments with Nile](https://medium.com/@martriay/manage-your-starknet-deployments-with-nile-%EF%B8%8F-e849d40546dd)
+
+## Development
+
 ### Set up the project
 Clone the repository
 
@@ -34,14 +139,12 @@ python3 -m venv env
 source env/bin/activate
 ```
 
-Install the [Nile](https://github.com/OpenZeppelin/nile) dev environment and then run `install` to get [the Cairo language](https://www.cairo-lang.org/docs/quickstart.html), a [local network](https://github.com/Shard-Labs/starknet-devnet/), and a [testing framework](https://docs.pytest.org/en/6.2.x/).
+Install Nile:
 ```bash
 pip install cairo-nile
 nile install
 ```
 
-## Usage
-
 ### Compile the contracts
 ```bash
 nile compile --directory openzeppelin
@@ -95,30 +198,15 @@ tests/test_Initializable.py .                              [ 89%]
 tests/test_Ownable.py ..                                   [100%]
 ```
 
-## Learn
-
-### Contract documentation
-* [Account](docs/Account.md)
-* [ERC20](docs/ERC20.md)
-* [ERC721](docs/ERC721.md)
-* [Contract extensibility pattern](docs/Extensibility.md)
-* [Proxies and upgrades](docs/Proxies.md)
-* [Utilities](docs/Utilities.md)
-### Cairo
-* [StarkNet official documentation](https://www.cairo-lang.org/docs/hello_starknet/index.html#hello-starknet)
-* [Cairo language documentation](https://www.cairo-lang.org/docs/hello_cairo/index.html#hello-cairo)
-* Perama's [Cairo by example](https://perama-v.github.io/cairo/by-example/)
-* [Cairo 101 workshops](https://www.youtube.com/playlist?list=PLcIyXLwiPilV5RBZj43AX1FY4FJMWHFTY)
-### Nile
-* [Getting started with StarkNet using Nile](https://medium.com/coinmonks/starknet-tutorial-for-beginners-using-nile-6af9c2270c15)
-* [How to manage smart contract deployments with Nile](https://medium.com/@martriay/manage-your-starknet-deployments-with-nile-%EF%B8%8F-e849d40546dd)
-
 ## Security
 
 This project is still in a very early and experimental phase. It has never been audited nor thoroughly reviewed for security vulnerabilities. Do not use in production.
 
 Please report any security issues you find to security@openzeppelin.org.
 
+## Contribute
+OpenZeppelin Cairo Contracts exists thanks to its contributors. There are many ways you can participate and help build high quality software. Check out the [contribution](CONTRIBUTING.md) guide!
+
 ## License
 
 OpenZeppelin Cairo Contracts is released under the [MIT License](LICENSE).