Writing docs & fixing flow reading strategy