* add & restructures some barebones to documentation
* fefactored update logic with itertools.chain