You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@openoffice.apache.org by Kay Schenk <ka...@gmail.com> on 2013/10/22 01:57:48 UTC

help for "bundled help"

Maybe it's time we broached the subject of  the "bundled" help with Apache
OpenOffice once again.

There was actually some initial movement on this topic when this project
was first set-up at Apache:

https://cwiki.apache.org/confluence/display/OOOUSERS/Application+Help

in July of 2011. (I've recently added what I know.)

And, there have been a few threads concerning it both on the "doc" list and
here on "dev".

Recently, I decided to take a look at what's involved with the "bundled"
help -- creating a new page, editing an old section, etc. -- and was really
stymied by the only document we seem to have on it, even with the
integrated "Help Authoring" macro (thank you Juergen).

So, what are our thoughts at this point?  Keep in mind that this is a part
of the actual product.

Should we *try* to migrate to something else? Or, if that is simply not
feasible, work toward some better/simpler instructions for how to deal with
the current system?


-- 
-------------------------------------------------------------------------------------------------
MzK

"There's so much boldness in living life this way ...
 we did it all, and no one can take it away from us."
                            -- Diana Nyad

Re: help for "bundled help"

Posted by Kay Schenk <ka...@gmail.com>.
On Mon, Oct 21, 2013 at 5:13 PM, Ariel Constenla-Haile
<ar...@apache.org>wrote:

> Hi,
>
> On Mon, Oct 21, 2013 at 04:57:48PM -0700, Kay Schenk wrote:
> > Should we *try* to migrate to something else?
>
> The Help is available for extension developers [1], "something else"
> would mean an incompatible change, and any incompatible change should
> wait until AOO 5;
>
of course, that "else" could be backwards compatible
> during AOO4 lifetime, but this would overcomplicate development (besides
> that "something else" means writing new code and somebody has to do
> this).
>

OK, good points -- something this major should be reserved for a major
version change. I don't see a new "help" environment as being backward
compatible, or  a need for something like that as currently "help" for a
version is already bundled with it.



>
> [1]
> http://wiki.openoffice.org/wiki/Documentation/DevGuide/Extensions/Help_Content
>
>
> Regards
> --
> Ariel Constenla-Haile
> La Plata, Argentina
>



-- 
-------------------------------------------------------------------------------------------------
MzK

"There's so much boldness in living life this way ...
 we did it all, and no one can take it away from us."
                            -- Diana Nyad

Re: help for "bundled help"

Posted by Ariel Constenla-Haile <ar...@apache.org>.
Hi,

On Mon, Oct 21, 2013 at 04:57:48PM -0700, Kay Schenk wrote:
> Should we *try* to migrate to something else?

The Help is available for extension developers [1], "something else"
would mean an incompatible change, and any incompatible change should
wait until AOO 5; of course, that "else" could be backwards compatible
during AOO4 lifetime, but this would overcomplicate development (besides
that "something else" means writing new code and somebody has to do
this).

[1] http://wiki.openoffice.org/wiki/Documentation/DevGuide/Extensions/Help_Content


Regards
-- 
Ariel Constenla-Haile
La Plata, Argentina