Re: [documentation-dev] Help Local and Internet

2008-11-18 Thread Frank Peters

Hi Cor,


Some time ago, there was some discussion about this subject.
At the OOoCon I was in a small group with some ideas about it.

So now I wonder what the status of the subject is. Can anyone pls tell?


The project is on hold, there were some ideas but we came against
some obstacles, both technical and legal that needed to be resolved.

If I find some time, I'll write it up and post it to the alias,
maybe you have some ideas how to overcome the obstacles.

So, basically, it is desirable to connect application help
and help content living online but we haven't found a solution yet.

Frank

--
Frank Peters
Documentation Project Co-Lead

The OOo Documentation Project:
SIGN UP - PARTICIPATE - CONTRIBUTE
IT'S FREE! NO OBLIGATIONS!
http://documentation.openoffice.org
http://wiki.services.openoffice.org/wiki/Documentation


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: [documentation-dev] Help Local and Internet

2008-11-18 Thread Cor Nouws

Hi Frank,

Frank Peters wrote (18-11-2008 10:11)


At the OOoCon I was in a small group with some ideas about it.


The project is on hold, there were some ideas but we came against
some obstacles, both technical and legal that needed to be resolved.

If I find some time, I'll write it up and post it to the alias,
maybe you have some ideas how to overcome the obstacles.


Might be, if I know them ..


So, basically, it is desirable to connect application help
and help content living online but we haven't found a solution yet.


The ideas we were talking about:
- choice for user to install local Help or not (just because people like 
to work offline as well);

- when local Help is available: offer extra online as choice (if available);
- when no local Help is available: of course offer online

Hmm... I doubt if this will help to solve your challenges ;-)

Regards,
Cor

--
Cor Nouws-nl.OpenOffice.org marketing contact
=  2008: The Year of 3  =  www.nieuwsteoffice.nl  =

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: [documentation-dev] Help Local and Internet

2008-11-18 Thread Frank Peters

Hi Cor,

At the OOoCon I was in a small group with some ideas about it.


The project is on hold, there were some ideas but we came against
some obstacles, both technical and legal that needed to be resolved.

If I find some time, I'll write it up and post it to the alias,
maybe you have some ideas how to overcome the obstacles.


Might be, if I know them ..


Give me some time to write it up

Thanks
Frank

--
Frank Peters
Documentation Project Co-Lead

The OOo Documentation Project:
SIGN UP - PARTICIPATE - CONTRIBUTE
IT'S FREE! NO OBLIGATIONS!
http://documentation.openoffice.org
http://wiki.services.openoffice.org/wiki/Documentation


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: [documentation-dev] Help Local and Internet

2008-11-18 Thread Uwe Fischer

Hi,

On 11/18/08 11:06, Cor Nouws wrote:

Hi Frank,

Frank Peters wrote (18-11-2008 10:11)


At the OOoCon I was in a small group with some ideas about it.


The project is on hold, there were some ideas but we came against
some obstacles, both technical and legal that needed to be resolved.

If I find some time, I'll write it up and post it to the alias,
maybe you have some ideas how to overcome the obstacles.


Might be, if I know them ..


So, basically, it is desirable to connect application help
and help content living online but we haven't found a solution yet.


The ideas we were talking about:
- choice for user to install local Help or not (just because people like 
to work offline as well);
- when local Help is available: offer extra online as choice (if 
available);

- when no local Help is available: of course offer online



the main technical challenges to get the OOo Help online may be these:

current Help is context-sensitive in multiple ways: it knows the 
application or module (as Writer, Calc, etc) in which you are, it knows 
the OS platform, and it knows the current menu command or icon or dialog 
box for which you want help. We need a way to pass this information to 
the online files.


current Help files use a lot of inline switching to display different 
contents with respect to the user's OS, the current module, and the OOo 
versus StarOffice software. We must decide how to map these differences 
to the web based files.


current Help files are extensively tagged with additional information, 
most important are the paragraph_id numbers: all contents are to be 
exported and re-imported to some translation tools.


to assure easy community collaboration, the online Help should be 
available on the OOo Wiki. But we have no automatic processes yet how to 
export and import contents to the Wiki and back to the installed files, 
conserving all the tags.
And there is no decision what happens when a translated version gets 
updated - currently the translation of Help contents is a one way from 
English to other languages.


Just to name a few difficulties. Any ideas are welcome.

Uwe
--
  [EMAIL PROTECTED]  -  Technical Writer
  StarOffice - Sun Microsystems, Inc. - Hamburg, Germany
  http://documentation.openoffice.org/
  http://wiki.services.openoffice.org/wiki/Documentation
  http://blogs.sun.com/oootnt
  http://user.services.openoffice.org/en/forum

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]