Tutorial docs improvement metabug

[pnkfelix]

Our tutorial(s) have problems.

This is a metabug to collect those issues together.

(A metabug seems especially appropriate when it comes to the manual and the tutorials, since someone fixing one problem in a document may be in a good position to fix other related problems, so cross-referencing here seems good.)

Do try to restrict the scope of this metabug to either pure documentation issues or to file organization / naming issues. (I.e. tooling for automatic testing or doc extraction is not part of the scope of this metabug.)

[brson]

Thanks for collecting these.

[huonw]

cc @erickt (and anyone else organising the doc sprint, (@steveklabnik?)).

This might (a) give some ideas for what would be good to focus on, and (b) give some for a "docs style guide" (not directly related to this bug, but on this last point, see also: #4361, #9403).

[steveklabnik]

Agreed.

[steveklabnik]

I don't think this metabug is still very useful, all open issues are tagged docs, and some issues are basically speculative. Does anyone object to simply closing?

[tshepang]

@steveklabnik no one objects :)