sonsi

Thank you – I really appreciate it!

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….