Docs suggestions post

[rho]

Have any suggestions for things that you think should be documented but aren't, things about the current documentation that you think need improving, or any "hey, wouldn't it be neat if..." ideas that pertain to docs? Comment here with them, and I'll either fix them, put them in zilla, or explain why I don't want to do them.

Comments

[qilin]

This one is kind of relevant, but doesn't include anything about changing warnings!