RE: [platform-help-dev] Remote Help

["Mark Ayad" <mayad@xxxxxxxxxx>]

Dorian> all the help rendering in eclipse (tables of contents and help
content)
Dorian> will be done in an external browser

Please don't drop the internal OLE embedded help system 'totally' in favour
of
an external browser. For me having a help system in the 'same context' of
the
workbench is fantastic, and is fits well with the vision of the workbench
paradigm.
I'm totally aware that I'm running in a near perfect case i.e Windows
Platform with
OLE IE 5.5.

So Please Please leave the 'option' of having internal OLE embedded help
system for
the platforms that support it.  If you need more reasons why then I'll
gladly send
them to you. Externalising things waters down the power of having within
arms reach
on the workbench.

Keeping everything including help 'In Context' is the most effective aid you
can
give to a developer.

As a developer the answer to a problem starts with a question. If that
question
can't be answered off the top of your head then thats when you consult the
documentation.
One nice idea would allow the bookmarking of pages just like you can
bookmark code,
an in my opinion this is what I would class as an 'infoview' ie a particular
'bookmarked'
view of the information.


Best Regards




-----Original Message-----
From: platform-help-dev-admin@xxxxxxxxxxx
[mailto:platform-help-dev-admin@xxxxxxxxxxx]On Behalf Of
birsan@xxxxxxxxxx
Sent: Wednesday, November 21, 2001 12:29 AM
To: platform-help-dev@xxxxxxxxxxx
Subject: Re: [platform-help-dev] Remote Help


Hi Mark,

It's good to hear you're doing great migrating to the new help system. We
are trying to collect migration tips into a document, so if you have any,
please post them. Likely, migration to 2.0 should be fairly straighforward.

Extending local documentation with "books" on the web is a really good
idea, but so far we haven't given it much attention. There are a few things
that we're doing now that will likely make your proposal easier to tackle:
- all the help rendering in eclipse (tables of contents and help content)
will be done in an external browser
- we are working on an "infocentre" type of help system, where someone
would install plugins on a host running eclipse behing a web server and
clients access help using a web browser
- the 2.0 tables of contents use a document linking mechanism that can
perhaps be extended to docs outside the local installation

If I understand it correctly, your idea is really a step or two further,
and allow for better integration of help content on a local machine with
that on remote servers. I didn't quite get the LDAP scenario. Are you
implying supporting non-eclipse based help libraries, or only being able to
find/get them from some locations?

-Dorian







                    "Mark Ayad"
                    <mayad@xxxxxxxxxx>              To:
<platform-help-dev@xxxxxxxxxxx>, <Greg_Adams@xxxxxxx>
                    Sent by:                        cc:
                    platform-help-dev-admin@e       Subject:
[platform-help-dev] Remote Help
                    clipse.org


                    11/20/2001 10:56 AM
                    Please respond to
                    platform-help-dev





Hi All,

I'm getting on just fine converting all sorts
of books and docs to use the help system in V2.

I have however thought of an extention

1) Dynamic XML _nav

To date the _nav for a book is static. One idea
would be to specify a internet based help library:

http://www.eclipse.org/library/

or even

http://www.eclipse.org/articles

or even use LDAP query

The XML _nav is dynamically built. The content for
the books would also reside on the remote server.

One option could be to 'make the book local' ie
re-createthe books nav and contents on the local
computer for 'off-line' mode.

This would be just perfect for web sites offering
help or articles or even full books eg I.B.M Redbooks

Just think of the posibilites !!!

Best Regards

Dr Mark Ayad

Ogilvy Interactive Paris

0033 (0)1 40 76 23 29



_______________________________________________
platform-help-dev mailing list
platform-help-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/platform-help-dev



_______________________________________________
platform-help-dev mailing list
platform-help-dev@xxxxxxxxxxx
http://dev.eclipse.org/mailman/listinfo/platform-help-dev