doc + fix asSample