finished documentation for v1