12

I've been adding some tag-wiki entries, (e.g. for , , and , and ). I'm happy to add more, but I'm wondering whether what I've done matches what people have in mind for a tag-wiki entry. Clearly there are different requirements for an entry on a topic (like the entry) and an entry for a package like the and entries.

Since the entries don't get any feedback (other than a mod approving them) it's hard to know if this work is useful or elicits a kind of "well it's not very good but better than no entry at all" response.

So what makes a good tag-wiki entry? (Also, is there a way to make the examples listed appear in the html as an actual tag would?)

4
  • 1
    You can use [tag:tagname] to link to a tag in markdown.
    – Caramdir
    Commented Feb 23, 2011 at 21:32
  • @Caramdir Thanks. That was was I was looking for. (Although that doesn't seem to do the css magic of putting up the black box with the exceprt text and the links to the tag-wiki entry itself.)
    – Alan Munn
    Commented Feb 23, 2011 at 21:46
  • That doesn't work on meta (but works in tag wikis).
    – Caramdir
    Commented Feb 23, 2011 at 21:48
  • @Caramdir, @Alan: With my browser settings, the second line starts with the "," after "{linguistics}". Seems to be a rendering bug; I've filed a bug report.
    – Hendrik Vogt
    Commented Feb 24, 2011 at 8:31

1 Answer 1

Reset to default
9

Suggestions for a good tag wiki:

  • A brief introduction

  • Further explanation

  • Links to related packages and classes

  • What the tag is not about: links to tags which might be a better choice in some circumstances

  • A link-list of closely related, but more specific tags, which might be a good specific choice

  • Links to highly voted questions resp. answers on the site, like a tag FAQ

6
  • great list! do note that the tag faq is generated automatically by inferring cross-linked posts, e.g. tex.stackexchange.com/tags/tikz-pgf/faq -- this only tends to work well on popular tags simply due to question volume
    – Jeff Atwood
    Commented Feb 23, 2011 at 18:10
  • 1
    Also note that special formatting, like backticks and tag links do not work in the excerpt.
    – Martin Tapankov
    Commented Feb 23, 2011 at 19:57
  • @Stefan Points 4 and 5 are very helpful; thanks. Point 2 is a tad vague :-) W.r.t. related packages and classes, I assume that makes sense for a topic tag as opposed to a package tag? Or should e.g. the memoir tag also point to KOMA (and vice versa)? Maybe that's too extreme a case. Should the longtable tag also point to supertabular?
    – Alan Munn
    Commented Feb 23, 2011 at 20:00
  • @Martin Actually my question about formatting was in this question (or in the tag-wki entry itself: is there a way in markdown to identify something as a tag so that it does the css magic that happens when you hover over a tag link?)
    – Alan Munn
    Commented Feb 23, 2011 at 20:03
  • @Alan: Not that I know of. I figured I should mention this, since I've seen a few tag wikis just today in which formatting has been used, and when hovering it doesn't look very nice.
    – Martin Tapankov
    Commented Feb 23, 2011 at 20:06
  • @Alan: Links to related packages and topics are good, even if they are "competitors" - good to point to alternatives. A tag wiki could be a small knowledge base to a topic, even if a certain package causes the topic. Related information is contained in the right sidebar or in the automatic faq, as Jeff said, nevertheless a manual choice might be a good addition.
    – Stefan Kottwitz Mod
    Commented Feb 23, 2011 at 20:38

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .