I go to these sources because I know they are official. I have found some of these are better updated than others and/or provide better information.
If I still can’t find the information I need I will reach out to Stack Overflow, Reddit, IRC.
I would like to see a consolidated source of at least official documentation.I think Rust does a good job of organizing and cleaning itself up in terms of source code. Doing the same with the documentation would be well received!
Each may have a different purpose conceptually but in reality they all contain useful information that all put together gives a better and more whole picture. Furthermore, isn’t it a nightmare keeping different documents up to date? The standard API docs are just about perfect because they are searchable and have a good mixture of explanation and examples. However, since other sources exist, I would like to see this organized into one location.
Some examples of the problem
The Book has longform writing but also has several examples. It also usually links to the API documentation or other references throughout a particular section.
RustByExample contains lots of stuff the Book does not. For example, I could not find anything about HashMap in the Book(and had no way to search) for it if it was bundled in somewhere I would not expect.
RustByExample has a section about Threads. The Book’s section is called Tasks.
To me, the ideal document would have the 1 2 3 4 5 hierarchy the Book has and filled in with the RustByExample hierarchy within those levels. The body of the particular topic would consist of what the Book has. The top has a table with links to the API(if applicable) or general domain information. More examples and Reference(specification) is folded into this document as it’s own section.
Eliminate the Reference document(as a separate doc).
Eliminate RustByExample.com or have it point to this new document.
Keep documentation DRY the same as you would code.
I would prefer if there was only a single source of documenation. Everything should be part of what currently the API docs are.
The tutorial can be added as separate resources to rustdoc. The Reference and advanced parts of the bookcan be added in the same way. Rustbyexample examples can be added where they fit in the api since they do not have a particular order.
The ideal would be something like the python docs for me.