[wp-docs] Features List

[Carthik Sharma]

Podz, and the others,

My original idea for the features page was a comprehensive listing of
the features of wordpress, as would interest a future user.

The author of that page would have to use some discretion as to the
granularity of resolution -- for example, we would not want to write
"All menu items formatted as lists"
since "produces semantic code" covers the above.

Likewise, wpautop can be left out since we already say that WP
produces elegant text formatting or something similar.

In short, the page should be the answer to the question:
"Where can I find a comprehensive list of features offered by wordpress?".

Podz, would you rather I started work on it at Codex? I could set up
the page initially and make it available for fleshing out.

The utility of such a page would be that it would serve as an
introduction to the features offered by wordpress, with links to
details about the features, which could be
a) How To pages ( like how to blog by email)
b) Description of functions/terms (like post-meta)

And like I said before these pages could be linked off of the "more
details..." links at the end of each feature in the list.

To begin with a standalone document with a list of features, with not
_more_ than a line or two describing the essence of each feature would
be great.

Again, I could start it off, what do you guys say?

Please do not confuse this with an user manual of any sort :)

Great to see active discussion here, again.

Regards,
Carthik.

On Tue, 21 Sep 2004 00:01:28 -0400, Justin Moore <justin at wantmoore.com> wrote:
> Podz wrote:
> 
> > Craig Hartel wrote:
> >
> >> This definitely warrants more discussion. Because this is a list of
> >> features, my instinct would be to limit the level of detail. I also
> >> agree with you, Podz, that it might serve as a good index.
> >
> >
> > If it wasn't for the caffiene, I'd be asleep by now :)
> 
> Yeah - you and me both...
> 
> >
> > Okay.. so we need a brief page of WP features, but we also need a more
> > in-depth list for people that does not drag them into any sort of manual.
> > We also need an index and all that leads from it.
> >
> > How about .... we use Carthik's work in the first instance as an
> > index, and take the main structure as the admin tabs.
> >
> > The brief page of WP features already exists - it's the list on the
> > front of wp.org
> >
> > The more in-depth page can be created by culling elements from the
> > index, maybe with selected sentences from the 'manual' being added ?
> > After all, the in-depth page should feature highlights rather than
> > nitty-gritty which should be expected in the product ?
> >
> > If this index will come about, then effectively the writing of the
> > 'manual' is naturally next on the list. Matt said earlier that 76
> > people should be reading this email, so once the index is complete,
> > would there be volunteers for contributing to certain sections ? I
> > mean, I can write all about File Uploads, but you really don't want me
> > trying to explain permalinks. You don't :)
> 
> I'd be more than glad to contribute. It's something I've wanted to do
> since I subscribed to this list, I've just never been really sure where
> to begin. Such a daunting task really, but with a few people who can
> head it up and help coordinate the development of it, it should be much
> easier. Now we just have to wait for the other 74 to respond.
> 
> >
> > Has anyone done anything on a 'manual' ? There must be various bits
> > and pieces knocking around.....
> 
> There was the WordPress User Manual idea prior to the release of Mingus
> (http://wiki.wordpress.org/UserManual), but I would imagine that you, as
> well as the rest of us, have seen that already. 'Twas a fantastic idea
> and most of the work that was done on it is excellent in my opinion.
> I've used it as a reference myself on more than one occasion.
> 
> Justin Moore
> Webmaster Extraordinaire
> www.wantmoore.com
> www.justinandbonnie.com
> www.getoffthecomputer.com
> www.necessaryhosting.com
> www.necessarytech.com
> 
> 
> 
> _______________________________________________
> docs mailing list
> docs at wordpress.org
> http://wordpress.org/mailman/listinfo/docs_wordpress.org
> 



-- 
When nothing is done, nothing is left undone -- 老子 Lǎozi

University of Central Florida

<a href="http://www.spreadfirefox.com/?q=affiliates&amp;id=2904&amp;t=1">Get
Firefox!</a>
Homepage: http://carthik.net