[Gambas-user] Restructuring the official Gambas examples

[Randall Morgan]

What I was trying to say was that I think having a small document
explaining the example implementation within the example would be helpful.
I don't think it should be in the Language documentation but in the
example's directory. Nothing really involved, and this may be most
appropriate for the simpler examples that you would expect someone just
starting with Gambas to use. But that is just my two cents worth :-)


On Wed, May 1, 2013 at 9:50 AM, Tobias Boege <taboege at ...626...> wrote:

> On Tue, 30 Apr 2013, Fabien Bodard wrote:
> > 2013/4/30 Tobias Boege <taboege at ...626...>
> >
> > > On Mon, 29 Apr 2013, Beno?t Minisini wrote:
> > > > I have never found the time to write good examples so you have my
> full
> > > > blessing.
> > > >
> > > > Just don't work directly on the current examples
> > > > (/trunk/examples/example). Just create a new directory
> > > > ('/trunk/examples/src' for... example) where you will store all the
> > > > example projects, with the structure you want. Once done, I will
> modify
> > > > the IDE to point at the new structure.
> > > >
> > >
> > > I merely thought of just adding a Niveau=X token to the .project file
> of
> > > examples. This would require minimal changes to the actual directory
> > > structure because this grouping of projects by topic shall persist. I
> would
> > > rather change the default *sorting* within these groups to ascend in
> their
> > > Niveau values and display the niveau level somewhere around the
> example's
> > > description (in bold).
> > >
> > > Since the IDE happens to parse each example's .project anyway to
> display
> > > other information this imposes no huge extra costs and can be turned
> off if
> > > someone wants (an extra RadioButton or two to select the sorting scheme
> > > will
> > > be needed, though).
> > >
> > > I think just a special file in the example project will be sufficient.
> >
> > like
> >
> > [Example]
> > Level=Beginner
> > KeyWords=RadioButton, TreeView, Printer
> > Description="This is an example about how to use some control and print
> the
> > result."
> > Description[FR]="Voici un exemple de comment...etc"
> > Description[ES]="hola... etc"
> > Description[IT]="salve"
> >
> >
> > Then we can add a special form in the ide to manage the examples with
> this
> > file, so examples can be sorted, searchable,
> >
> >
> > Each examples must be Fully documented using internal help.
> >
>
> Benoit, do you have the same objection with a distinct .example file in
> example project directories, which is kind of Fabien's suggestion, as your
> veto was with new keys to .project?
>
> Regards,
> Tobi
>
>
> ------------------------------------------------------------------------------
> Introducing AppDynamics Lite, a free troubleshooting tool for Java/.NET
> Get 100% visibility into your production application - at no cost.
> Code-level diagnostics for performance bottlenecks with <2% overhead
> Download for free and get started troubleshooting in minutes.
> http://p.sf.net/sfu/appdyn_d2d_ap1
> _______________________________________________
> Gambas-user mailing list
> Gambas-user at lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user
>



-- 
If you ask me if it can be done. The answer is YES, it can always be done.
The correct questions however are... What will it cost, and how long will
it take?