19 Dec
2007
19 Dec
'07
4:02 p.m.
> 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).
-----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
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