19 Dec
2007
19 Dec
'07
2:58 p.m.
Ok, I know this comes off as nitpicking (not trying to, just sharing my own confusion)..
To download Xwiki, I click "Download". All options are clearly labelled, and I
know what I'm getting when I select one of them.
I would have thought to get documentation, I click "Documentation".. Or even
"Support", as with most other product sites.
As an uninitiated user, I would have no clue what each of the options are.
(Bear with me a moment for the comparison)
As a comparison, I dropped into MediaWiki's homepage (mediawiki.org).
First thoughts: boring and tedious. But any potential user can immediately find the
distribution or the documetation. The whole process of finding/accessing takes a few
seconds.
-----Original Message-----
From: users-bounces(a)xwiki.org [mailto:users-bounces@xwiki.org] On Behalf Of Vincent
Massol
Sent: 19 December 2007 13:15
To: XWiki Users
Subject: Re: [xwiki-users] Documentation?
On Dec 19, 2007, at 2:06 PM, Esbach, Brandon wrote:
I'd have to suggest though that it's not as
intuitive as it once was.
I'd agree but that doesn't bother me since xwiki isn't what it used to be.
Even the previous xwiki.org wasn't as intuitive as xwiki was when everything was
fitting on one page ;)
What I'm interested in thought it is to make it as intuitive *as possible*.
Even a search on "documentation" returns no
results (for me, anyway).
The search isn't working so no wonder.... :)
Can there not be a documentation panel to get quick
access to each
product's documentation?
There is one already... It's called "XWiki Ecosystem". Or do you mean
something else?
Thanks
-Vincent
-----Original Message-----
From: users-bounces(a)xwiki.org [mailto:users-bounces@xwiki.org] On
Behalf Of Vincent Massol
Sent: 19 December 2007 12:44
To: XWiki Users
Subject: Re: [xwiki-users] Documentation?
On Dec 19, 2007, at 1:09 PM, Víctor A. Rodríguez wrote:
_______________________________________________
users mailing list
users(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/users
Vincent Massol wrote:
yes but I would say that's normal.
I'm curious to know. Do others have this
issue finding documentation
too?
My main problem is that some links have been moved and need to be
located the first time I try to reach them, e.g.
http://www.xwiki.org/xwiki/bin/view/AdminGuide/InstallationMySQL,
http://www.xwiki.org/xwiki/bin/view/UserGuide/Features (and all the
UseGuide related links).
IMHO, the real problem is that now the wiki is
more product oriented,
instead of features oriented.
Well that's not fully true. You can't compare with before since before
we were only documenting one product and now we're documenting the
platform and all the products...
I remember the previous one were the first you
found were all the
features that XWiki has. This is what you want to look at when you
arrive to a site in search for a product, a quick view of features to
stay with the product or to move on to the next one.
Again, IMHO, not a good move. :-(
You mean the new xwiki.org is not a good move?
Past users of xwiki.org should go to the http://enterprise.xwiki.org
since the previous version was only documenting that. Then you should
be able to find all you had before.
Back to your feature-oriented documentation idea. Do you have any
example of web site in mind that do this? (I mean websites with more
than one product). Or any idea how to implement this?
OTOH all the sites I know that have more than one product do it the
way we do it on xwiki.org:
- http://apache.org, http://jakarta.apache.org
- http://hibernate.org
- http://jboss.org
- etc
We could show all the platform features on the main page since all
products share these but I don't think that would be a good idea since
we would then not be able to present the different products (not
enough space).
I guess what I'm trying to understand right now is why is it difficult
to pick the product for which to read documentation about.
Would you have any insight into this?
Thanks
-Vincent
BTW, thanks Vincent for asking and search for
problems to solve.
_______________________________________________
users mailing list
users(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/users
_______________________________________________
users mailing list
users(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/users
> Hi,
>
> You can find documentation by product using the "XWiki Ecosystem"
> panel.
>
> For example if you search XWiki Enterprise documentation you click
> on "XWiki Enterprise" that go to
> http://enterprise.xwiki.org/xwiki/bin/view/Main/ where you find a
> "Quick Links" panel containing documentation.for XE.
>
> 2007/12/19, Esbach, Brandon <Esbachb(a)tycoelectronics.com>om>:
>
>>
>> Hi all,
>>
>> Probably missing the link somewhere, but I can't seem to find any
>> links for the documentation on the xwiki.org site?
>>
--
Víctor A. Rodríguez (http://www.bit-man.com.ar) El bit Fantasma
(Bit-Man) - Algorithm junkie Perl Mongers Capital Federal
(http://cafe.pm.org/) GNU/Linux User Group - FCEyN - UBA
(http://glugcen.dc.uba.ar/
_______________________________________________
users mailing list
users(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/users