On Sun, 13 Apr 2014 17:27:28 +0200, Caig wrote:
perhaps, what we need to do is put together some sort of "new
user survey" to find out the sorts of things new users find they need
to know or would like to learn about.
I really like the idea: focus on the users (and potentially new
contributors, the future of the project)
Well, ideally most of the documentation that's on the website should be
targeted at new users, I think. The focus for new contributors is
somewhat different, depending on the nature of the contribution they want
+1 writing/updating pages (even a single one a single
time) and keeping
all the wiki structured (or grouped if structured sounds heavy/too
limiting) are two different tasks.
Even to avoid duplication of effort like these for example -
or poor orphans barely
Exactly - that's why structure is needed - you end up with duplication,
and with duplication, you have the serious potential for multiple
conflicting ways to handle things. While there may be multiple ways to
do things, for new users particularly, the simplest way to get things
going is with the simplest procedure.
Understanding the interdependencies between different parts of a
knowledge domain is also important in order to build a flow. Even if a
user starts with implementing LAMP, they might need some prerequisite
knowledge on Apache, MySQL, or PHP. If there aren't references like
that, then users end up frustrated because they'll read an instruction
and say "but I don't know how to do that - where do I go look?" and they
can't find it.
Please keep on-topic replies on the list so everyone benefits
To unsubscribe, e-mail: opensuse-project+unsubscribe(a)opensuse.org
To contact the owner, email: opensuse-project+owner(a)opensuse.org