News for hackers. Stuff that matters.
Re:I’m a productive programmer with a memory of a fruit fly by sodapopcan on Monday September 19, 2022 @03:04PM (#32902481)
Yes. Test _can_ very much be documentation if you write them as such, although they aren't complete documentation. Tests are the specification, ie the the how---documentation provides the why.

Test can be written to tell a story but most people aren't taught this way (or simply don't buy it or don't write tests).

Re:I’m a productive programmer with a memory of a fruit fly by marcosdumay on Monday September 19, 2022 @04:33PM (#32903544)
No, tests are not specification, they are examples, specifically on the form "do this, and this happens".

Imagining a specification out of this is like solving those problems of "what is the next number on this sequence: 1 18 31". It's simply can not be done, you can guess something, but you will never know if it's the real answer.

Re:I’m a productive programmer with a memory of a fruit fly by sodapopcan on Monday September 19, 2022 @11:10PM (#32907215)
That _can_ be examples but I prefer to write them as specs. I mean, there are entire libraries centred around writing tests as specs. Just because you don't do it that way or buy into the idea doesn't mean it's not possible or valuable.
Re:I’m a productive programmer with a memory of a fruit fly by marcosdumay on Monday September 19, 2022 @11:28PM (#32907328)
Specs are complete. If you create real world software with complete tests, I will really want to read your Turing Award receiving discourse. It should be great.