I think it would be interesting to guide the user on its first steps, to engage him/her, using the Help-Mode interface of the REPL. I did a first searching whether this is posted somewhere but with no success.
I try to clarify my idea
help?> search: ⊻ ⊋ ⊊ ⊉ ⊈ ⊇ ⊆ ≥ ≤ ≢ ≡ ≠ ≉ ≈ ∪ ∩ ∛ √ ∘ ∌ ∋ ∉ ∈ ℯ π ÷ ~ | ^ \ > < : / - + Welcome to Julia 0.7.0-DEV.3465. The full manual is available at https://docs.julialang.org/ as well as many great tutorials and learning resources: https://julialang.org/learning/ For help on a specific function or macro, type ? followed by its name, e.g. ?cos, or ?@time, and press enter. For first steps guide try: ?+ and press enter.
Note the last line. What I think is useful is to build a net which connects the help docs of the julia functions in a coherent way. It would follow like so
help?> + search: + .+ +(x, y...) Addition operator. x+y+z+... calls this function with all arguments, i.e. +(x, y, z, ...). Examples ≡≡≡≡≡≡≡≡≡≡ julia> 1 + 20 + 4 25 julia> +(1, 20, 4) 25 dt::Date + t::Time -> DateTime The addition of a Date with a Time produces a DateTime. The hour, minute, second, and millisecond parts of the Time are used along with the year, month, and day of the Date to create the new DateTime. Non-zero microseconds or nanoseconds in the Time type will result in an InexactError being thrown. Similar functions: -, *, / Try: ?methods or ?
Note the last two lines. It groups similar functions which the user can interact with and the next line presents a way of going forward or backward in thi guide.
I think of course this guide should be build as simple as possible. My idea would be to build a graph to group and connect all reasonable methods and the Help-Mode could check each time if it should print the guiding lines.
What are your ideas? Should I open an issue in Github?
Thanks for reading this