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

[adalger]

S2

[rho]

Do you have any specific thoughts on what needs to be documented or how it should be organised? I know that our S2 documentation is woefully inadequate, but I suck at S2 and all things styles related, so I don't really have a firm grasp of what needs doing.

[adalger]

s/woefully inadequate/nonexistent/

Everything from how to get to the "developer area" to what the available language is. First in importance, I think, is a list of what the backend supplies and what each thing means. If I had to point fingers, I'd point 'em at afuna, foxfirefey, and branchandroot to have good answers to this question. Meantime, I'm thinking a post over in style_system and dw_styles asking for a wishlist might be very productive.

[rho]

I'm going to do a bit of asking around of people who know more S2 than I do, and see what sort of plans we can come up with.