From vincent@massol.net Tue Jan 27 14:10:08 2009
From: Vincent Massol <vincent@massol.net>
To: xwiki-devs@xwiki.org
Subject: Re: [xwiki-devs] [xwiki-notifications] r15759 - in platform:
	core/trunk/xwiki-core/src/main/resources
	xwiki-applications/trunk/administration/src/main/resources/XWiki
Date: Tue, 27 Jan 2009 14:26:04 +0100
Message-ID: <233478F1-563F-40E7-99EE-0EDD710D23C2@massol.net>
In-Reply-To: <c58832290901270513r24a71c07i33d249d3f05c65b@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============2348040441773229487=="

--===============2348040441773229487==
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable


On Jan 27, 2009, at 2:13 PM, Jean-Vincent Drean wrote:

> On Tue, Jan 27, 2009 at 12:35 PM, Vincent Massol =20
> <vincent(a)massol.net> wrote:
>>
>>> +dateformat=3D<a href=3D"http://platform.xwiki.org/xwiki/bin/view/AdminGu=
ide/Configuration#HDateformat
>>> ">Date format</a>
>>
>> hmm... do we want this? Are we already linking from the source to
>> external documentation?
>
> The only other place I know is Main.WebHome linking to the user guide.

Which is not part of the interface. Thus I'm even more tempted to say =20
that we shouldn't link to the xwiki.org in the interface as much as =20
possible.

This is why I created that syntax page inside XE and not pointing to =20
xwiki.org BTW.

>> The risk is that it's going to be very easy to break the link when we
>> reorganize documentation and that it requires internet connection.
>
> About reorg I could point to the main page of the Admin guide which is
> less likely to change.
> I'm not sure that the need for an internet connection is a show
> stopper, we should continue to allow ourselves to point to external
> urls from the default wiki imho (to point to documentation).

I think it's a bit of a pain for users and again it's going to break =20
in the future for sure. I can guarantee it (already happened in the =20
past).

> note: which reminds me that we must remove the xwiki.org RSS feed from
> XWiki.Admin profile, since it _blocks_ page rendering when
> disconnected
>
>> The alternative could be to have a tooltip with the format defined in
>> there.
>
> I think a tooltip might be a little small to display info about date =20
> formatting.

I didn't mean tooltip in the literal sense. I meant a Help icon =20
(question mark) and when you click on it it displays help (in a popup =20
dialog box for ex) or by inserting some HTML content inside the page =20
(as Hudson is doing). Would be good to generalize this to all elements =20
in the preferences for example.

Thanks
-Vincent
http://xwiki.com
http://xwiki.org
http://massol.net







--===============2348040441773229487==--