[Gambas-user] Some more example projects to be distributed with gambas

[Bruce Steers]

On Sat, 2 Sept 2023 at 12:08, Martin Fischer <martin.fischer6 at web.de> wrote:

> >
> > Are the "example" programs well documented?
> >
> > you can post them here...
> > http://gambaswiki.org/wiki/app <http://gambaswiki.org/wiki/app>
> >
> > and here...
> >
> https://forum.gambas.one/viewforum.php?f=13&sid=02b6ad70ecd1d329705bcd041622459e.
> <
> https://forum.gambas.one/viewforum.php?f=13&sid=02b6ad70ecd1d329705bcd041622459e
> .>..
> >
> > There's a few other forums too.
> >
> > BruceS
> >
>
> Hi Bruce,
>
> now I'm confused...
>
> First of all, "well documented" is very subjective.
> - Are these examples as well documented as the other examples
> distributed with gambas? Yes :-)
> - Are they documented good enough? Depends. They try to show a single
> thing. They are minimal. Not much documentation needed then. But surely
> they do not explain all knowledge that is required to build them. For
> example: the database examples use a DataSource control and arrange the
> data-bound controls as children of it. Why? That's something the gambas
> documentation shall explain. It's not documented as part of the example.
> And that's fine.
>
> After this rant: here's how I see it as a learner of gambas:
> When I want to learn something new I do:
> 1. Read the documentation.
> 2. Go over tutorials. I used the examples distributed with gambas for
> that. Some were helpful, some not. That's normal.
> 3. Write my own examples to familiarize myself with the ecosystem.
>
> The examples distributed with gambas are tutorials. This means:
> - there shall be many of them...
> - each area of gambas shall be covered by at least one example
> - each example shall focus on one topic only (sure: not always possible)
>
> This means that an example is not some random app that someone wrote to
> solve a real (business-)problem. They are meant to be educational!
>
> I see the apps mentioned in the wiki and hosted on the software farm as
> the real application that do something useful.
>
> To sum this up:
> - educational, tutorial-style examples: distributed with gambas
> - real apps: hosted on software farm and/or mentioned in the wiki/app
>
> Am I wrong with this view?
> What is your take on this?
>
> Regards,
> Martin
>

I think if every "gambas learner" as you describe yourself wants their
examples distributed with gambas itself then gambas would soon become a
HUGE download.

I think the examples included with gambas should be written by someone who
knows gambas inside and out not just a newb who's really proud of themself.
(We've all been there) ;)

I think sometimes I am too cheeky for my own good ;) lol

I also think my opinion does not really matter, I'm just going blah blah
blah here,
if Benoit likes your examples then maybe hell add them to the collection?

But I think it's what the farm was designed for, so people can put their
examples there. no need to add more to everyones gambas download.

Unless it's a well documented/commented example that'll help with
understanding.  ;)
again , just my humble opinion, Benoit might not want it even if it is well
documented.

I guess it's just food for thought.

Respects
BruceS
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.gambas-basic.org/pipermail/user/attachments/20230902/2d3540f3/attachment.htm>