First, forgive me for not writing this in last month when #Rust2018 occurred. I was so busy and stressful with my career even on most of the weekends. Even this post was written at the TET holidays(I am living in Vietnam), while visiting Singapore for a vacation.

Some of these suggestions are not entirely new and have been added as posts/ comments on /r/rust, Github threads. But I believe better listing down all in a one place, because now we are in the correct time even I am bit late. Also forgive me if somebody got upset with some content of this post.

01. Documentation 📖

“We repeat what we don’t repair.”

— Christine Langley-Obaugh

It should not take more than two weeks to conquer on Rust

2015-2016 : No single place to cover all the areas

» Rust reference & v1 Documentation to understand the concepts.

» Rust by example & Cargo documentation to understand usages of syntax and IRC channels to get more help.

The main issue of the first documentation was content of some pages was highly coupled with some other pages, so newcomers had to read x,y,x,z,x pages to understand the contents of x page. We had to do the same with reference but because of it was a long single page at that time, it didn’t feel that much bad.

2016-2017 : More content added to v2 documentation

» Less coupling between pages.

» Having a better order compared to v1.

» More content merged from reference & Rust by example and cargo doc.

» More detailed explanations.

I don’t know why we create an another version of doc, without fixing the first version. Even now I prefer some pages of the first version compared to it’s replacements on second, especially because of more concise descriptions.

2018–2019 : single place to cover all + more concise content

» Should target all newcomers instead experienced system programmers.

» Should have a short and sweet documentation to learn things quickly.

» Guessing Game can be the right answer for wrong question.

» We need a UI/ UX refresh.

Rust is considered as a language which is difficult to learn. After getting the “Guessing Game” just after the “Hello world!”, I doubt that how many new comers continue learning Rust.(unless he/she is a systems programmer)

In the past years I suggested above changes many times in /r/rust but the default answer was “different people have different learning styles” and I also agree with it. But as a single person the only thing I can do is prepare a prototype to show that things can be better.