[Gambas-devel] Ok, I've started on the help text

Benoît Minisini gambas at ...1...
Thu Dec 10 13:40:18 CET 2009


> I've pulled gb3 rev 2471 and I'm about to start work on rewriting the help
> text.
> 
> The existing directory structure will be 100% maintained, without change
> (/../help/help/help/...).
> 
> Whilst I will regularly pull later versions of gb3 to see if svn pulls in
> any help changes, I would really appreciate being alerted if the help text
> changes.
> 
> 1) The help text will be rewritten in XHTML 1.1
> 2) Existing icons will be used wherever possible.
> 3) Images will be updated wherever possible.
> 4) The index frame will be retained.
> 5) I will concentrate on gb3 only.
> 
> I have yet to decide on a plan of attack. I'll publish it when I decide
>  what the best approach will be.
> 
> Fabien: No doubt you will need samples to test with the new
> "on-the-fly-popup-help". Let me know when I can take a look at the feature.
> 

OK, now I understand what you want to do. 

But beware that:

* This online help is automatically *generated* from the wiki contents by 
using "wget" and a few magic file and HTML link renaming because of bugs in 
the way wget handles that.

* The online help is not used anymore by the Gambas 3 IDE. It will be removed 
from the source package, as it takes a lot of bytes. This is the reason why I 
asked you why not writing directly in the wiki.

* Moreover, who will translate your documentation if it is not in the wiki?

-- 
Benoît Minisini




More information about the Devel mailing list