The 'too much data' wasn't just towards you :) Not intended to be that
way, sorry if it was.
I agree, the purpose is to inform (teach) people, but we have to find
a balance between teaching and overwhelming. Their brains will get
full (Farside joke).
Why don't we start with the links under "Learn How to Use WordPress"
Getting Started with WordPress is listed twice, we can obviously remove one.
WordPress.tv and WordPress Lessons are for external sites - Should
they be listed on the front page of the codex at all? Should we have
a separate section for 'useful external but still related sites'?
Quoting Spencer Hill <[email protected]>:
Sorry to chime in late here, my message didn't get posted for some
reason. This was written a few days ago in reply to Mika's response
on the 26th:
I agree that there was too much data there. In my defense, I only
added the first paragraph and the "For Non-Developers", anything
after that was already there.
While simplicity is key, the purpose of the codex is to inform
visitors. So wouldn't it be a mistake to omit critical information
simply because we don't think people will read it? Or because it's
not aesthetically pleasing? What if we set our goal on being clearly
and concisely organized rather than being "simple'? That way we
understand that we're only omitting information on a particular page
if it's not relevant, premature or repetitive?
With regards to "Installation" being the first topic to address, it
brings us back to the current problem with the existing and previous
layouts: we're alienating end users who just want to learn how to
use WordPress.
Does anyone object to having at least two different sections on the
front page so as to respect the two critically different types of
users we have (developers and non-developers)?
_______________________________________________
wp-docs mailing list
[email protected]
http://lists.automattic.com/mailman/listinfo/wp-docs
_______________________________________________
wp-docs mailing list
[email protected]
http://lists.automattic.com/mailman/listinfo/wp-docs