yes, Kafkaesqui, exactly. what i think would be nice would be:
1) an overview, or listing, of the tag types, as seen in each link you provided above;
2) another section wherein each tag is listed with (a) a simple description of the tag, and (b) a list of possible parameters.
i don't think usage info or examples would be necessary. my idea is to be able to browse through to see if a tag exists with whatever functionality i might want to implement... if it does, i can go look up the details of how to use it online. to me, this is just easier on hard copy than clicking through webpages. i can scan through much more quickly this way, and get a stronger understanding of what can be done within wordpress.
parameter details aren't really necessary either, because i can see that being a pain to include, even though it would be nice. i think i would also leave out deprecated tags, because i would want to avoid them anyway - and if i don't see them, i'm not tempted to use them.
basically, i think it should be a list that's streamlined as much as possible, while still providing the functional information for each tag.
anyway, that's just my idea/request. maybe i am the only new user who finds such references useful in hard copy! i hope not :). i don't mean to impose this on you or anyone if it's not already done. if i had the time, i would probably sit and make one for myself.
******
as an example, the copy might have a format like:
[section1]
Here is a categorical listing of wordpress template tags:
Author Tags
- the_author
- the_author_description
- the_author_login
- etc...
Category Tags
- the_category
- the_categoory_rss
- etc...
Continue With Other Tag Types
- etc...
[section 2]
let's describe the tags!
Author Tags
the_author
Displays or returns the name of the author for a post. This tag must be used within The Loop. Parameters: idmode, display.
the_author_description
Displays the content of the Profile: field in a user's profile for the author of a post. The Profile is a block of text often used to describe the user, and can be quite large. This tag must be used within The Loop. Parameters: none.
.....etc....
Category Tags
the_category
Displays a link to the category or categories a post belongs to. This tag must be used within The Loop. Parameters: separator, parents.
the_category_rss
Displays the name of the category or categories a post belongs to in RSS format. This tag must be used within The Loop. Parameters: type.
single_cat_title
....and so on....
sonsi
sonsica
Root
