[rarestia]

Good code is its own best documentation.

You're assuming that developers document their code properly.

As someone who scripts in Powershell, I can tell you that while the big code repositories have decent documentation, pseudo-code is almost non-existent in most public repositories.

I spend more time writing pseudo-code for my programmers than I do actually writing documentation. They don't want to do it. They just want me to tell them how to translate it from what the customer wants to how it needs to be coded.

[Buckeye McFrog]

A very senior Oracle consultant once said about his new assignment:

“They have all sorts of different systems running here. And as near as I can tell, absolutely none of it is documented. All of the documentation is in the head of an employee named Sri. And, as near as I can tell, if Sri goes out for lunch and gets hit by a bus, this company goes out of business fifteen minutes later.”

[tacticalogic]

As someone who scripts in Powershell,

And here I thought I was the only POSH-head on FR!