Updated docs: renamed flatten_dict and added note about it being optiona...

...l