9 Feb
2017
9 Feb
'17
3:22 p.m.
Hi all,
For the 9.1 roadmap, see
http://www.xwiki.org/xwiki/bin/view/Roadmaps/#HXWiki9.0-9-2, Caty and I
have worked on a Help Center to cover the "Demo Content" and (partially)
the "In-Product Tours and Documentation" topics. I opened this issue
http://jira.xwiki.org/browse/XWIKI-14018 to follow the progress. I
committed a first working version on
https://github.com/xwiki/xwiki-platform/tree/feature-help-center .
I committed the code in platform mainly because we already have a
xwiki-platform-help-ui module which is related, but we can discuss putting
the help center in a different place:
* either a separate child module of xwiki-platform-help (to separate the
help center from the rest of the help pages like the XWiki syntax help and
the tips panel)
* on xwiki-contrib
Caty named it "Help Center" in the initial proposal, then used "Help"
in
the prototype. We need to decide which one is best. I'm fine with both. The
version I committed uses "Help Center".
The help center pages have quite a few images and 4 big gifs (animated
steps) which leads to a 22Mb XAR. I hope the size won't cause any issue. It
may slow down the XWiki Enterprise functional tests setup?
Caty and I would like to put the help center pages on playground.xwiki.org
so that we can measure if it's useful (without having to wait for the
playground wiki to be upgraded to XWiki 9.1).
WDYT?
Thanks,
Marius
9 Feb
9 Feb
3:31 p.m.
Hi Marius,
On 9 Feb 2017, at 15:22, Marius Dumitru Florea
<mariusdumitru.florea(a)xwiki.com> wrote:
Hi all,
For the 9.1 roadmap, see
http://www.xwiki.org/xwiki/bin/view/Roadmaps/#HXWiki9.0-9-2, Caty and I
have worked on a Help Center to cover the "Demo Content" and (partially)
the "In-Product Tours and Documentation" topics. I opened this issue
http://jira.xwiki.org/browse/XWIKI-14018 to follow the progress. I
committed a first working version on
https://github.com/xwiki/xwiki-platform/tree/feature-help-center .
Thanks. I’ve also raised a few questions on http://jira.xwiki.org/browse/XWIKI-14018
I committed the code in platform mainly because we
already have a
xwiki-platform-help-ui module which is related, but we can discuss putting
the help center in a different place:
* either a separate child module of xwiki-platform-help (to separate the
help center from the rest of the help pages like the XWiki syntax help and
the tips panel)
* on xwiki-contrib
I think it would make more sense on xwiki-contrib since we’d want to possibly release it
more often than the core (add new content or fix/modify existing content) and I don’t
consider it core.
Caty named it "Help Center" in the initial
proposal, then used "Help" in
the prototype. We need to decide which one is best. I'm fine with both. The
version I committed uses "Help Center”.
Help Center is fine with me. I’m also fine with both.
The help center pages have quite a few images and 4
big gifs (animated
steps) which leads to a 22Mb XAR. I hope the size won't cause any issue. It
may slow down the XWiki Enterprise functional tests setup?
1) What are those 4 gifs doing? Do they require maintenance? Can we reduce their size?
2) For XE functional tests that’s ok since we would bundle the Help Center app by default
so only the functional tests for the help center itself would incur the extra size (but I
don’t see it as a big issue).
Caty and I would like to put the help center pages on
playground.xwiki.org
so that we can measure if it's useful (without having to wait for the
playground wiki to be upgraded to XWiki 9.1).
WDYT?
+1
Thanks
-Vincent
Thanks,
Marius
3:54 p.m.
On Thu, Feb 9, 2017 at 4:31 PM, Vincent Massol <vincent(a)massol.net> wrote:
Caty used a tool (I don't remember the name) to record the steps needed to
perform some action (e.g. insert and edit a wiki macro through the WYSIWYG)
as a GIF. Similar to what Guillaume did for
http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/Data/XWiki/8.4.2/#HLocaliz…
. Now, I see that Guillaume's GIF is 400kb (compared to Caty's 2-3Mb) so
maybe there's a way to generate smaller GIFs, but it may require reducing
the quality. In any case, I think they are useful, but they do require
maintenance..
Hi Marius,
It would also allow us to install and upgrade the help center on playground
template more easily (through the EM) instead of using XAR import. The only
(minor) issue is that the help center shares the "Help" space and more
importantly the Help.WebHome page with the xwiki-platform-help-ui module.
On 9 Feb 2017, at 15:22, Marius Dumitru Florea
<
mariusdumitru.florea(a)xwiki.com> wrote:
Hi all,
For the 9.1 roadmap, see
http://www.xwiki.org/xwiki/bin/view/Roadmaps/#HXWiki9.0-9-2, Caty and I
have worked on a Help Center to cover the "Demo Content" and (partially)
the "In-Product Tours and Documentation" topics. I opened this issue
http://jira.xwiki.org/browse/XWIKI-14018 to follow the progress. I
committed a first working version on
https://github.com/xwiki/xwiki-platform/tree/feature-help-center .
Thanks. I’ve also raised a few questions on http://jira.xwiki.org/browse/
XWIKI-14018
I committed the code in platform mainly because
we already have a
xwiki-platform-help-ui module which is related, but we can discuss
putting
the help center in a different place:
* either a separate child module of xwiki-platform-help (to separate the
help center from the rest of the help pages like the XWiki syntax help
and
the tips panel)
* on xwiki-contrib
I think it would make more sense on xwiki-contrib since we’d want to
possibly release it more often than the core (add new content or fix/modify
existing content) and I don’t consider it core.
Caty named it "Help Center" in the
initial proposal, then used "Help" in
the prototype. We need to decide which one is best. I'm fine with both.
The
version I committed uses "Help Center”.
Help Center is fine with me. I’m also fine with both.
The help center pages have quite a few images and
4 big gifs (animated
steps) which leads to a 22Mb XAR. I hope the size won't cause any issue.
It
may slow down the XWiki Enterprise functional
tests setup?
1) What are those 4 gifs doing? Do they require maintenance? Can we reduce
their size?
2) For XE functional tests that’s ok since we would
bundle the Help Center
app by default so only the functional tests for the help center itself
would incur the extra size (but I don’t see it as a big issue).
Caty and I would like to put the help center
pages on
playground.xwiki.org
so that we can measure if it's useful
(without having to wait for the
playground wiki to be upgraded to XWiki 9.1).
WDYT?
+1
Thanks
-Vincent
Thanks,
Marius
3:58 p.m.
On 02/09/2017 09:54 AM, Marius Dumitru Florea wrote:
On Thu, Feb 9, 2017 at 4:31 PM, Vincent Massol
<vincent(a)massol.net> wrote:
gifsicle does lossless GIF optimization, give it a try.
--
Sergiu Dumitriu
http://purl.org/net/sergiu
1) What are those 4 gifs doing? Do they require
maintenance? Can we reduce
their size?
Caty used a tool (I don't remember the name) to record the steps needed to
perform some action (e.g. insert and edit a wiki macro through the WYSIWYG)
as a GIF. Similar to what Guillaume did for
http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/Data/XWiki/8.4.2/#HLocaliz…
. Now, I see that Guillaume's GIF is 400kb (compared to Caty's 2-3Mb) so
maybe there's a way to generate smaller GIFs, but it may require reducing
the quality. In any case, I think they are useful, but they do require
maintenance..
13 Feb
13 Feb
3:17 p.m.
On Thu, Feb 9, 2017 at 4:58 PM, Sergiu Dumitriu <sergiu(a)xwiki.org> wrote:
On 02/09/2017 09:54 AM, Marius Dumitru Florea wrote:
to
On Thu, Feb 9, 2017 at 4:31 PM, Vincent Massol
<vincent(a)massol.net>
wrote:
> 1) What are those 4 gifs doing? Do they require maintenance? Can we
reduce
their
size?
Caty used a tool (I don't remember the name) to record the steps needed perform some action (e.g. insert and edit a wiki
macro through the
WYSIWYG)
as a GIF. Similar to what Guillaume did for
http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/Data/XWiki/8.4.2/#
HLocalizationSection
. Now, I see that Guillaume's GIF is 400kb
(compared to Caty's 2-3Mb) so
maybe there's a way to generate smaller GIFs, but it may require reducing
the quality. In any case, I think they are useful, but they do require
maintenance..
gifsicle does lossless GIF optimization, give it a
try.
It doesn't very help much. We have 6 GIFs between 1.7 and 5 MB, and 15.73
MB in total. After executing
gifsicle -O3 --no-extensions
the total size is reduced only by 0.16 MB, so we're still left with 15 MB
of GIFs.
I'll try to optimize the images also, which take the rest of 7 MB.
Thanks,
Marius
--
Sergiu Dumitriu
http://purl.org/net/sergiu
5:01 p.m.
On Mon, Feb 13, 2017 at 4:17 PM, Marius Dumitru Florea <
mariusdumitru.florea(a)xwiki.com> wrote:
On Thu, Feb 9, 2017 at 4:58 PM, Sergiu Dumitriu
<sergiu(a)xwiki.org> wrote:
On 02/09/2017 09:54 AM, Marius Dumitru Florea
wrote:
to
On Thu, Feb 9, 2017 at 4:31 PM, Vincent Massol
<vincent(a)massol.net>
wrote:
> 1) What are those 4 gifs doing? Do they require maintenance? Can we
reduce
their
size?
Caty used a tool (I don't remember the name) to record the steps needed perform some action (e.g. insert and edit a wiki
macro through the
WYSIWYG)
as a GIF. Similar to what Guillaume did for
http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/Data/XWiki/
8.4.2/#HLocalizationSection
. Now, I see that Guillaume's GIF is 400kb
(compared to Caty's 2-3Mb) so
maybe there's a way to generate smaller GIFs, but it may require
reducing
the quality. In any case, I think they are
useful, but they do require
maintenance..
gifsicle does lossless GIF optimization, give it
a try.
It doesn't very help much. We have 6 GIFs between 1.7 and 5 MB, and 15.73
MB in total. After executing
gifsicle -O3 --no-extensions
the total size is reduced only by 0.16 MB, so we're still left with 15 MB
of GIFs.
I'll try to optimize the images also, which take
the rest of 7 MB.
With optimized GIFs and PNGs the size of the XAR is now 18.8 MB.
Thanks,
Marius
--
Sergiu Dumitriu
http://purl.org/net/sergiu
9 Feb
9 Feb
5:22 p.m.
On Thu, Feb 9, 2017 at 3:22 PM, Marius Dumitru Florea <
mariusdumitru.florea(a)xwiki.com> wrote:
Hi all,
For the 9.1 roadmap, see
http://www.xwiki.org/xwiki/bin/view/Roadmaps/#HXWiki9.0-9-2, Caty and I
have worked on a Help Center to cover the "Demo Content" and (partially)
the "In-Product Tours and Documentation" topics. I opened this issue
http://jira.xwiki.org/browse/XWIKI-14018 to follow the progress. I
committed a first working version on
https://github.com/xwiki/xwiki-platform/tree/feature-help-center .
I committed the code in platform mainly because we already have a
xwiki-platform-help-ui module which is related, but we can discuss putting
the help center in a different place:
* either a separate child module of xwiki-platform-help (to separate the
help center from the rest of the help pages like the XWiki syntax help and
the tips panel)
* on xwiki-contrib
Caty named it "Help Center" in the initial proposal, then used "Help"
in
the prototype. We need to decide which one is best. I'm fine with both. The
version I committed uses "Help Center".
I've used 'Help' in order to be smaller on the breadcrumb, more
recognizable and generic, and to have a single word in the AppBar, menus.
The help center pages have quite a few images and 4 big gifs (animated
steps) which leads to a 22Mb XAR. I hope the size won't cause any issue. It
may slow down the XWiki Enterprise functional tests setup?
Caty and I would like to put the help center pages on playground.xwiki.org
so that we can measure if it's useful (without having to wait for the
playground wiki to be upgraded to XWiki 9.1).
WDYT?
Thanks Sergiu for the GIF suggestion.
Caty
Thanks,
Marius
2822
days inactive
2826
days old
6 comments
4 participants
participants (4)
-
Ecaterina Moraru (Valica) -
Marius Dumitru Florea -
Sergiu Dumitriu -
Vincent Massol