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

[Fabien Bodard]

2009/12/10 Kadaitcha Man <nospam.nospam.nospam at ...176...>:
> 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.
>
>
> ------------------------------------------------------------------------------
> Return on Information:
> Google Enterprise Search pays you back
> Get the facts.
> http://p.sf.net/sfu/google-dev2dev
> _______________________________________________
> Gambas-devel mailing list
> Gambas-devel at lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-devel
>

<FR>je pense que tu devrait commencer par regarder a ce qu'est
gambasdoc avant de te lancer... a tu essayé le wiki, regardé les
système d'alerte pour les update ?, le système d'information aux
traducteur si la version de base (anglais est modifée), le système
'diff  qui permet de trouver facilement ou sont les modification a
apporter dans les traductions (historique des modification), les liens
automatique au autres pages en fonction des mots clef. Gambasdoc n'est
pas qu'un simple tas de pages statiques sur le web. Bien sur je suis
d'accord sur un point avec toi la présentation doit être changée pour
plus de clartée, mais ça ne nécéssite pas de tout refaire... juste
aménager certaine présentation automatiques liées au moteur wiki. Il
faudrait aussi une page notes libre pour chaque pages et accessible
par tout le monde pour chaque langues, qui permettrait de librement
completer la doc par les expériences individuelles. Un arbre (ou plan
de page), simplifierait la navigation. Un système de recherche plus
souple pourrait aussi être apporté. Avec des exemples assez parlant
lié aux pages. Mais basé sur le moteur wiki pour les lien
automatiques... comme chez qt.

Donc voici mon avis pour l'instant... c'est oui pour améliorer le
wiki, et non tout réécrire comme tu le pense n'apportera rien de plus
que ce que je viens de citer.

Et donc si tu veut contribuer  et changer les textes de la doc certes
parfois mal formulé, il me semble que le mieux restera le wiki, qui
est le seul moyen de vraiement partager avec tout nos amis gambasian.

</FR>
<Google EN>
I think you should start by looking at what has gambasdoc before you
start ... have you tried the wiki, looked at the warning system for
the update?, system information to a translator if the basic version
(English is hereby amended), the system 'diff which allows to find
easily or are the modifications in translations (historical change),
automatic links to other pages based on keywords. Gambasdoc is not
just a bunch of static pages on the web. Of course I agree on one
point with you presenting must be changed for more clartée, but that
does not require any re ... just develop some automatic submission
engine-related wiki. It would also free notes page for each page and
accessible by everyone for every language, which would complete free
the doc by individual experiences. A tree (or plan page), simplify
navigation. A research system more flexible could also be provided.
With enough examples of speaking-related pages. But based on the wiki
engine for automatic link ... as in qt.

So here's my advice for now ... yes it is to improve the wiki, not
rewrite it as you think will bring nothing more than what I just
mentioned.

So if you want to contribute and change the text of the doc certainly
sometimes poorly worded, it seems that the best will in the wiki,
which is the only way to really share with all our friends gambasian.
</Google EN>