Use better specific specs and documentation

Per review feedback on #812.