Re: Reference manual + tutorials

[Ludovic Courtès]

Hello,

Ricardo Wurmus <address@hidden> skribis:

> Yes, this can work.  It’s hard for me to imagine where one would put
> prose that resembles a tutorial in our current manual.  It currently
> leans very heavily towards a reference manual, which discourages me from
> adding elaborate examples.
>
> There’s also the danger of interrupting the flow with too many big
> inline examples.  Currently, it is easy to understand the big picture
> because the prose isn’t separated by step for step instructions.

Yeah, I agree.

> It would be sad to miss out on good tutorials just because they don’t
> fit into the current manual; and it would be just as sad to clutter the
> manual by filling it with tutorials that would seem out of place.

Sure.  So I think those tutorials that don’t fit in the manual should
really have their own life, and that’d be great!

Ludo’.