In contrast to the disadvantages...
It's not that bad...
Several positive aspects of programming language documentation can be mentioned (based on
Tuple class[
^]):
1. there you'll find the definition of class/method/event:
public static class Tuple
2. it contains information about:
a) namespace:
System
b) library/assembly:
System.Runtime.dll
c) description of what this class/method/event is for and what it does (Remarks):
A tuple is a data structure that...
d) framework version (aplies to):
.NET
5 Preview 1
.NET Core
3.1 3.0 2.2 2.1 2.0 1.1 1.0
.NET Framework
4.8 4.7.2 4.7.1 4.7 4.6.2 4.6.1 4.6 4.5.2 4.5.1 4.5 4.0
...
3. sample code (in most cases)
4. reference to other sources (
see also
)
Without the documentation, we won't be able to find that basic information.
Finally, i must admit that would be much better to see more details, more examples, etc. Thankfully, on NET there's tons of tutorials, articles, tips.