[wp-docs] Documenting WPs Other Functions

[tg at tannagh.com]

Has any thought been given to documenting some of the other functions of
WP? The Template Tags are pretty well documented, as is a couple of the
non-template tags, such as those that support "the loop".
http://codex.wordpress.org/The_Loop

But there are others available out there. Like the ones to get comments.
I'm asking because I came across comment_excerpt() and thought about
using it in my new template. But the most I could get out of the
documentation was this: "This tag must be within The Loop, or a comment
loop." Okay, so how do I make a comment loop? Ultimately I looked at my
comments.php file to see how it's made. In there I see this code: <?php
if ( comments_open() ) : ?> Is this what gets the comments? Or are they
automaticaly retireved when the post is gotten? - as I write this, I
realize that's a conditional tag.

I'm now realizing some of what I wrote is moot, I just need to look in
the right place. But that does bring up something I noticed. include
tags and conditional tags are not on the front page, but template tags
are. Yes, I know you can get to the others from the template tage page,
but I wonder if they should also be on the front page. If some one is
looking specificaly for a cond tag, they may not think to look on the
template tags page first to get to the link (I didn't).

-tg