[xwiki-users] Documentation?

[Esbach, Brandon]

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 at xwiki.org [mailto:users-bounces at 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 at xwiki.org [mailto:users-bounces at 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:
>
>> 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 at tycoelectronics.com>:
>>>>
>>>>>
>>>>> 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 at xwiki.org
>> http://lists.xwiki.org/mailman/listinfo/users
>
> _______________________________________________
> users mailing list
> users at xwiki.org
> http://lists.xwiki.org/mailman/listinfo/users
> _______________________________________________
> users mailing list
> users at xwiki.org
> http://lists.xwiki.org/mailman/listinfo/users

_______________________________________________
users mailing list
users at xwiki.org
http://lists.xwiki.org/mailman/listinfo/users