Yes! Thank you!
I’m glad that you too mention MATLAB as an example for how to write beginner-friendly help pages. Another thing I forgot to mention when I wrote about MATLAB was: the more you read the help pages the more you see certain common, fundamental concepts repeated in multiple places. You will keep finding, say, x = 0:pi/100:2*pi; or plot(x,y,'-o','MarkerSize',10); on so many different, seemingly unrelated help pages. This is of a paramount importance for a beginner, not only does it help user memorize through repetition the recommended ways to write certain things, but even more importantly it develops a sense of familiarity with the language, which in turn creates an impression that it is actually possible to master the language, which in turn creates a desire to further explore the language. As of now, it’s everything opposite with Julia (for me). Because Julia Base docs explained it somewhere how you can/should initialize a range of x values so if you really want to learn go and find it. And before anyone asks: “Are you asking developers to repeat the complete beginner 's guide for each Base function’s help page?”, please just check any of the linked MATLAB help pages from @chadagreene’s post. As I stated and he quoted: docs are virtually nothing more than formally correct, least common denominator pieces of information standing in total isolation from the other pieces of information. For sure there is some middle ground between formally correct barren landscape they are now and daft regurgitation of basic concepts in each and every help page. MATALB help pages are basically a template how to do it. I understand this is an enormous amount of work so I do not think anyone has any right to ask the developers to actually do it.