News for hackers. Stuff that matters.
Re:Minimal APIs at a glance in .NET 6 by kumarvvr on Monday September 13, 2021 @08:36AM (#28510688)
More importantly, if the default is to depend heavily on conventions, MS should have had a big glaring button / warning / notification in the Introduction page, which summarizes all the conventions used. Would have saved many beginners a lot of time.

I am an experienced programmer and was very frustrated having to search for all the conventions used in the framework.

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.
Re:Minimal APIs at a glance in .NET 6 by andix on Monday September 13, 2021 @08:50AM (#28510856)
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.
Re:Minimal APIs at a glance in .NET 6 by Rapzid on Monday September 13, 2021 @11:09AM (#28512445)
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.
Re:Minimal APIs at a glance in .NET 6 by andix on Monday September 13, 2021 @11:14AM (#28512502)
Totally. Most of the time I don’t even check the docs, I go straight away to the source code on GitHub.
Re:Minimal APIs at a glance in .NET 6 by oaiey on Monday September 13, 2021 @12:22PM (#28513388)
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.