Re:Minimal APIs at a glance in .NET 6
by SketchySeaBeast on Monday September 13, 2021 @11:03AM
(#28512367)
Absolutely. I've wasted hours doing things that, if I'd been shown the way Microsoft wanted me to do them, I'd solve in 10 minutes, but instead I need to spend a ton of time trying to figure out why the new variable on my model isn't binding correctly because I didn't realize they need to be properties.
That always drove me nuts. You need to learn all those conventions from the examples. And then you always got the strangest surprises and still needed to use attribute based routing.
Something that drives me crazy about the current ASP.NET Core documentation is that it is overly example based. I wish there were more comprehensive coverage of the subsystems.
Totally. Most of the time I don’t even check the docs, I go straight away to the source code on GitHub.
True story. We developers are an interesting species. Documentation is for us never sufficient because we want to know how the sausage is done down to the if statement.
And for good reasons.
I am an experienced programmer and was very frustrated having to search for all the conventions used in the framework.