Re:The Case for C# and .NET
by orthoxerox on Monday July 25, 2022 @06:04AM
(#32222453)
ASP.NET configuration is one of the most arcane parts of .NET that I don't like. You have to perform the incantation thrice: add package reference, add service reference, invoke the builder extension. And there's the right order and the wrong order of invocations, and if you pick the wrong one, your app silently won't work correctly.
Re:The Case for C# and .NET
by metaltyphoon on Monday July 25, 2022 @08:44AM
(#32223541)
Arcane? What did you expect? Add a package and magically everything works? If you make it work by just adding a reference its “too much magic”, if you make it so people write everything “it’s boilerplate” and if you do something in between “its arcane”.
Personally, I'd rather generate documentation at compile time.
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.
services.AddSwaggerGen();
app.UseSwagger();
app.UseSwaggerUI();