Okay, let's say someone told you about xwiki to
build your website,
giving you some examples like Curriki. You are interested and want to
see if it can fits your needs. You'll want to know how you can install
the product and adapt it to your needs, that may be wide.
This shows the fact that most "old" users now inherited an erroneous
concept: "xwiki". At first, you could talk about XWiki as something you
can use for making a website. Now, what you said is almost equivalent with:
"Okay, let's say someone told you about apache to host your website,
giving you some examples like wikipedia. You are interested and want to
see if it can fit your needs. You'll want to know how you can install
the product and adapt it to your needs, that may be wide."
Here, almost everyone knows that it shouldn't say "apache", but "apache
http server", as "apache" is no longer a valid alias for the http
server. But this confusion was happening a few years ago for apache,
too, when it was nothing more than THE http server, and not a foundation
with tens of famous projects. Still, some continue to say "apache" when
they talk about httpd, and some continue to say "XWiki" when they talk
about XWikiPlatform or XE.
Speaking about apache, there is no Documentation link on
www.apache.org,
so I only agree with the Documentation link on
www.xwiki.org for
historical purposes.
So e.g. I want to know how to make a site like
Curriki. How should I
proceed? And first, in which section should I have a look? There's
something missing here, maybe just a few words that say to me 'hey guy,
if you want to build a website upon XWiki, it's that way!'
+1, we're mostly documenting features and OpenSource development
practices. A complete tutorial should be written; for the moment, there
are some articles about setting up XWiki, they used to be linked
somewhere on
xwiki.org.
Or more basically, let's say that you have
installed a distribution of
XWiki Entreprise for you to test and let's even suppose that you have
clearly understood the difference between 'XWiki' and 'XWiki
Enterprise' (which is not always very clear for a newcomer if he heard
about XWiki as a something like 'MediaWiki' power 2).
Now you just want to build a new skin from scratch. Hmm... where should
you have a look into? XWiki Entreprise or XWiki Platform? If you feel
logical, providing you've downloaded and you're using XWiki Entreprise,
you'll have a look into the documentation for XWiki Entreprise. Well...
wrong guess, it's in XWiki Platform.
This is the goal of the home page. What's
missing do you think?
Something like a diagram (or a table, at least), showing in a glance which functionality
is part of which product.
Sergiu