Posting this as it deeply resonates with me
I find that the .NET/C# documentation has great guidance for old and new concepts. There’s reference docs with remarks, there’s guidance and best practice recommendations, and there’s examples and guided work-alongs.
Personally I’ve never done the examples or video or text follow-alongs. But I greatly value the concept guidance that goes beyond mere reference docs with remarks.
While it’s somewhat specific to the .NET/C# ecosystem, I imagine it’s valuable beyond it, and maybe a good example of how a big and significant enough project can provide more relevant and condensed information than “random tech blogs and websites” or similar.
I spent a lot of time using msdn Microsoft docs for windows and activex c++ back in the day. Faintly envious there are videos in the c# docs.
I changed tech stacks, but comments and examples are awesome to use inside docs. Usually in the php, it’s the comments in the docs that are the best help, and example code and work around can be found there.
But most php depends on the tens of thousands of projects and libraries made others: so the docs one needs is scattered in the dependencies. Some who have good docs (laravel) and some that have no docs , in which case a debugger is best way to learn.
