Re:The Case for C# and .NET
by silon42 on Monday July 25, 2022 @04:31AM
(#32221860)
Personally, I'd rather generate documentation at compile time.
[ Parent
| on HN ]
I do it during tests.
Since I'm already spawning a TestHost and trying out various API calls, one of these tests basically does "curl $host/openapi/openapi.json | diff ./docs/openapi.json". If it spots a change and fails the test, I check that the difference is expected, and if so I temporarily enable and run a different "test" which actually writes the updated file.