updated documentation + examples