[wp-docs] Lessons: Opinions Welcome...maybe
lorelle at cameraontheroad.com
lorelle at cameraontheroad.com
Mon Mar 28 15:51:18 GMT 2005
I've started the WordPress Lessons section on my user page at
started to group them together by category. In doing so, I'm having some
trouble figuring out where to put things and what categories should be
included. I talk about this on my user page and have opened up a debate on
my discussions page about this. Chime in, please.
I've done roughs of a bunch of the proposed lessons and posted them. Please
review, slash, and burn, but remember, I haven't even had a chance to do
much of a second or third go around with these.
I talked with Carthik for a few minutes this weekend about the title of the
WordPress Lessons and I really like calling them WordPress Lessons. If you
have an opinion on that, let us know, but I like the idea of that name and
then using the linking technique of calling them "Lesson: How to dn
Something" when linked to from other pages on the codex that require an
article title. Stands out, says what it is, differentiates it from
technical documentation as a how-to, and...well, what do you think?
And he mentioned listing this on the Main Page as a separate section. I
think that is wise since it is of benefit to the majority of WordPress
Users. WordPress is so EASY to use, a lot of people are embracing it and
then wanting to dig in to find out more, so I think this is a good thing.
It will lead people to dig deeper into the Codex to the rest of the
documentation by giving them a non-lethal, non-tech intro with links to the
lethal tech material...ah ha! BURN! ;-)
Now, about those Lesson articles.
Please review the Lessons very carefully. On the more technical issues
involving some template tags, I've test driven most of the, but not all of
them, so double check that I didn't screw up a tag or code example.
Remember - I still very much a newbie at how WordPress works and a tired
stip of the hinger and dah code ez messed upped. And remember again, I
haven't even gone through them since cleaning them up enough to post. I'm
sure I screwed up in places.
About Lessons Guidelines and Purpose:
I've also added a very rough draft and start to some guidelines for
submission to the Lesson section. This is NOT meant to turn into official
guidelines but to help me (and all you wonderful and worthy Codex helpers)
process what we want and don't want out of these lessons.
PLEASE chime in on these.
The basic goal of the Lessons in the Codex is to help people learn how to
use WordPress, especially how to use the tags, process the overwhelming
information and technology that goes into the WordPress features, and how to
maximize these features on their own WordPress site.
The number one criteria for inclusion in Lessons, IMHO, is that the lesson
must benefit the MAJORITY of WordPress users, not the minority.
I am not qualified to write on techie how to topics for WordPress, but I'd
love to have people submit Lessons on techie topics such as how to change
the excerpt and post content text area in the Admin to make it larger or
smaller; understanding more about how pingbacks, trackbacks, and RSS works
in relationship to a WordPress site. For example, do these help your link
popularity and rise in the search engines? Does the user have to "turn it
on" or is it on by default? Can they turn them off? What good do they do?
How can they be customized to do what you want? Sure, the tags and glossary
and a few pages list some of this information, but a how-to-use on these
would be great.
I'm sure there are plenty of other techie topics that I would absolutely
love to see added, but I'm tired out from Weekend Wikiness and I'll post
suggestions on my user page later.
So go through the Lessons and take a look. If the link is red - obviously I
haven't added anything yet. Still working on them. Sorry that they are
"empty" pages, but this is MY USER PAGE and not for the general public. The
red link reminds/haunts/guilts/encourages me to get the article done.
:::As a reminder to those new on the discussion group, these Lessons started
out as a cover for when the Codex was down for an extended period and v1.5
had just come out and people were going nuts on how to use it. We posted
"Lesson: title of lesson" on the WordPress forum and they were a big hit.
Requests came in to preserve this information and to add such information to
the Codex to benefit all WordPress users. From there...avalanche.
More information about the wp-docs