|And the problem is rarely ever reading the code.
Even when I find comments they're usually unclear and/or outdated.
I really don't care for inline comments, never have.
The problem is getting it to run locally and then releasing it to production.
I had to get a specific version of Node.js and npm, then I had to run some scripts.
Some thing never got to work because some style file was never in npm's build output.
I had to get passwords by finding config files in an Azure environment.
For release I hope for a well working pipeline, but unfortunately it wasn't working.
The programmer used a "windows-latest" machine and Microsoft had just changed "latest" from VS2019 to VS2022, which apparently was a problem for npm (I know, what the !? )
For some other task I had to run some specific scripts that were on the original programmer's computer (or in his head, maybe).
Another project I'm working on is doing everything in the database and using some background no-code solution to move everything around.
It's a nightmare and you can only know what being done with data by knowing it.
There's a tiny ASP.NET WebForms shell, but then there's a SQL Database with 100's (1000's?) of stored procedures, views, functions...
In both cases I could really do with some documentation.
How do I get this running? What's the overall setup? Where can I find configurations? What manual steps should I take? How do I deploy to various environments?
Just a neat Word document to get me started would do.