>We have so many cool mechanisms for in-image and external documentation now
>that I sometimes get confused!
The old "HelpSystem" that I wrote is in-image and was a first attempt on docu.
It can be used, but these days I REALLY prefer that we switch to "PharoOnlineHelp"
which is available in the config browser in Pharo 2.0.
=> just load it, start the server and open the browser
(the "Browse" button in the panel currently only works on Windows but you can point your webbrowser
to
http://localhost:8080/)
It uses Markup and you easily describe anything with it, also include pictures, videos and other
resources. Markup is also readable even when not converted to HTML.
After trying the demo just check class "PharoTutorial" especially methods #pharoTutorialOn:
and #onlineHelpTutorialOn: that should give you an idea how easy it is to write documentation
and tutorials.
Both methods just use the pragma <onlineTutorial> and work with a builder (similar to the menu extensions).
Simple - isnt it?
The new online help is now also independent from any help framework classes
(the subclassing on CustomHelp and its dependency was a problem for people like Lukas to write docu
with the old HelpSystem). All this is solved in the new PharoOnlineHelp - IT JUST HAS TO BE USED.
Maybe one can DEMO it on #pharoconf so it can be discussed.
I would like to see in the near future:
- people writing short tutorials using Markup with the <onlineTutorial> on their classes
- a community hosted Pharo image at "
http://help.pharo.org" with all these tutorials loaded so people
can use their webbrowser to get more infos on all the nice packages and frameworks
Any support welcomed!
Regarding other docu efforts:
=============================
Camillo also provides WebDoc - a more "reference" like help based on comments in the image.
PharoOnlineHelp has this as well, see the API menu in the online help.
I would like to see parts of WebDoc merged into the online help project. Camillo wanted
to look into this AFAIK.
So please: have a look, use it, report on it and help moving it forward
Bye
T.