documentation spit and polish