draft: how to write good userpic descriptions

[jadelennox]

I decided to write up a draft of how to write good userpic descriptions, because I am busily writing my own. (It takes a long time to write descriptions for 100+ userpics!) I am putting the draft here for kibitzing. Note that I am not a documentation writer by trade, and this is probably much too long and detailed! If somebody says "jadelennox, that's crap, I'm rewriting from scratch," I won't get offended.

( DRAFT: how to write a userpic description )

(rb, we haven't developed a tags list yet, but I would lean towards tagging something like this "draft" and "draft-howto". And maybe something indicating what kind of documentation it is discussing?)

Welcome to dw-accessibility!

[jeshyr]

We have an accessibility community!

So what do users want to put in it? I want to hear your opinions and thoughts and musings and anything else constructive please.

We also have an accessibility mailing list for the accessibility team volunteers, although it's fairly quiet at the moment.

I'm thinking that the community needs lots of "Accessibility 101" documents and links to relevant FAQs such as:

• What do I put in the "Description" field for my user icons?


• How to add links to your post in a friendly manner (aka Why "Click Here" is evil)


• etc.

And also we'll be open to answering user questions.

What else?