[jjgreen]

Accept it and make that explicit; make the code clear enough to be self-documenting. Trying to maintain documentation in parallel to a codebase is a fool's errand, it will end up dominating your work and lead to paralysis.