documentation improved v3