updated documentation .. FINALLY ... and fixed some snippets