I think we should create a docs folder with markdowns like ketos has: https://github.com/murarth/ketos/tree/master/docs