docs, specs, and general cleanup