19 Dec
2007
19 Dec
'07
3:50 p.m.
On Dec 19, 2007, at 2:58 PM, Esbach, Brandon wrote:
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.
That's because I've hadn't had the time yet to split the download page
into several! (one for each product).
I would have thought to get documentation, I click
"Documentation"..
Or even "Support", as with most other product sites.
Could you please point out just one to me please so that I can see it
in action?
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.
As I said this in my previous email this isn't a valid comparison
since Mediawiki is just one product: a wiki.
Thanks
-Vincent
-----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
_______________________________________________
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