On Friday, 24 June 2016 at 03:14:31 UTC, Carl Vogel wrote:
...
One thing that might encourage having people move further along
is to set up the interactive code sections as "quizzes." I.e.
have the visitor fill in code to give a certain output or pass
a unittest instead of just having a pre-written example. This
makes the tutorial more interactive and fun.
If this is geared towards real newcomers (not just c/c++
converts who are looking for quick reference), then I agree
with Ali that less text per section (even if you need lots more
bite-sized sections) would be best. If you look at the
interactive tutorial on e.g. haskell.org, it moves in VERY
small bits -- typing in math, sorting a list, etc. If even
Haskell is going to break things down so simply, surely we can
too. :)
Thanks guys for the feedback! Especially the navigation part is
already listed as an issue because it has been one of the
recurring problems users reported.
Regards,
André
