docs, specs, improvements