News for hackers. Stuff that matters.
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.
Re:The Case for C# and .NET by piaste on Monday July 25, 2022 @05:31AM (#32222258)
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.

Re:The Case for C# and .NET by wizofaus on Monday July 25, 2022 @05:01AM (#32222078)
Which you can do, by adding a post build step.