Re-organize the documentation

[alexgarel]

### Reorganize documentation
- [ ] Create dev documentation by taking scattered documentation in a more organized way (intro / how-to / etc) and replace by link to relevant parts
- [ ] Rethink README to link to documentation and only provide a short introduction
- [ ] Add more links on documentation introduction to relevant sub-parts