Documentation and iterative algorithm 

updated documentation, see /docs