Updated documentation to the latest state of the code ( and ideas )