documentation improved v2