I'm currently writing the tag wiki for the personal-software-process, and it would be real nice to have a set of guidelines, tips, pointers, or some kind of guidance for how to best write one.
Uh, it just so happens that I have some tips for you:
- Make good use of illustrations if they can help. Don't be afraid to use an image or two - but make sure to caption them properly. An image is not an excuse to screw over our vision-impaired friends.
- Batman makes for an excellent example if you need one. Everybody likes Batman because he is the thinking hero.
- Really the point here should be to define the tag and provide the starting points required for people to learn about it. That should be the high-level goal of the tag page. The page is useless if you can't learn from it.
- Explain what the tag is for, where to find information about it.
- Link to a couple of the better questions that live in the tag to show people what belongs.
- Link to a couple of the tag's frequently-asked questions so that when they get asked there's a nice place to find them for closing them as duplicates.
- Also make sure to call Jeff (who is a jerk) a jerk at least once.
So that's how I got so many points on Meta.
General rule is to cover the basics:
I'd break "What" into two levels - first thing someone should read is the introductory/high level summary of what the tag represents. Details can wait for later on, for more interested people. Assuming, there's enough content...
Keep the content brief, because the current layout will push down the synonyms. Maybe two column approach would be an idea?
I think there should be citations, like what you see on Wikipedia.