u/theindigamerin r/ProgrammingLanguages • Mentions
On “What do you consider the gold standards in programming language documentation?”
Before I say more, let me preface this by saying that I understand _why_ cppreference is the way it is. First of all, it is a reference, not a guide, so it should probably be held to a lower standard in terms of explanation compared to a guide. Second, C++ is probably one of the most complicated languages out there, which makes writing solid documentation for it much harder.
The problem, IMO, is that the _existence_ of cppreference means that people think "Oh, we already have good documentation for the standard library" and so there isn't a lot of effort put into documenting things better, especially for people who are still on their learning journey. I think cppreference assumes a minimum…