partially document the primitive template