Eric,
The way it comes across is you have some system that fakes actual passwords
being in documentation files without them actually being there, and this sounds
incredibly complicated and error-prone.
What would be a LOT better is to never even pretend or fake having passwords
where they shouldn't be, never put them in your documentation even temporarily.
Instead, have a system of named variables or entities where all your actual
documents simply indicate the name of a password, an identifier that itself is
not secret nor needs to be changed.
Then when someone is reading a document that talks about secrets, rather than
seeing the secret/password itself, they see the non-secret name, and then they
take that name and provide that to the secret server to get the actual password.
The secret names should be descriptive enough that people have an idea what they
are and if the secret server has a list of name-value pairs one can maintain
those easily enough independently.
So never put your passwords in your non-secret files to begin with.
-- Darren Duncan