19 Dec
2007
19 Dec
'07
5:21 p.m.
On Dec 19, 2007, at 4:02 PM, Esbach, Brandon wrote:
And on that page it asks you to choose a product.
Yes I can see this working so that users can navigate from 2 angles:
1) by product they're interested in
2) by type of information they're looking for (they'll be asked to
choose the product in that case)
> Could you
please point out just one to me please so that I can see
> it in action?
There's a lot of them, I agree most of those I use are
either single-
product support sites.
But here's one, for example: http://www.adobe.com/
The layout there is the kinda thing I'd think would work well for
xwiki.
Just hover over support to see a link for documentation, this takes
you to a documentation area. This approach might work for xwiki's diverse
product range as well,
as then you pick your product for more support.
Err, also I wanted to point out, I'm just sharing a concern here.
My intention is to just clear up potential confusion for new users
(if existing users are confused, I imagine new ones will be more so).
Thanks for sharing this. It helps.
-Vincent
-----Original Message-----
From: users-bounces(a)xwiki.org [mailto:users-bounces@xwiki.org] On
Behalf Of Vincent Massol
Sent: 19 December 2007 14:51
To: XWiki Users
Subject: Re: [xwiki-users] Documentation?
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.
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:
_______________________________________________
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 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:
> 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.
yes but I would say that's normal.
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.
>
>> 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
_______________________________________________
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