trying to describe what its all about

- added everything I can think of right now, waiting for feedback
- now the code is outdated, syncing with this documentation will be the next task