Re: Wiki Main Page (WAS -> Re: GambOS 2.0 release)

[gbWilly <gbWilly@xxxxxxxxxxxxxx>]

On Sunday, August 24th, 2025 at 15:10, gbWilly <gbWilly@xxxxxxxxxxxxxx> wrote:

> On Saturday, August 23rd, 2025 at 15:29, Lee t.lee.davidson@xxxxxxxxx wrote:
> 
> > On 8/23/25 8:20 AM, gbWilly wrote:
> > 
> > And, we have /three/ naming conventions pages:
> > https://gambaswiki.org/wiki/doc/naming (the original?)
> > https://gambaswiki.org/wiki/doc/namingconvention (written by Fabien Bodard)
> > https://gambaswiki.org/wiki/doc/convnaming (If I recall correctly, this one is a consolidation of the first two by Gianluigi
> > with input from list members.)
> > 
> > Could we decide on using just one of those to help minimize confusion?
> 
> 
> I suggests to use the one that is most complete and if needed improve on that and eliminate all others. This only creates confusion.
> Then on the 'Topics' page in the 'Beginners' section link only that one.
> 
> Talking about that beginners section, I plan on doing a small reorder there like so:
> - What is Gambas?
> - Getting started with Gambas
> - Starting Gambas for the first time (rewrite of How To Get Started)
> - Learning topics (new index page with links to all relevant learning pages on the wiki as Benoit explained -> means replacing some pages)
> 
> - Naming conventions (remastered version)
> 
> Idea here is that when you start reading above page in order there is a flow from "What is Gambas?" to "Starting Gambas for the first time" in what you read. You first read 'What is Gambas?' to get a general idea, next dive into 'Getting started with Gambas'. Here you will learn about what Gambas best to use in your situation, where to find some learning materials and how to get help. On next page (now named 'How To Get Started') this flow is broken as it start with installing again and seems old content from many moons ago, as binaries from your distro are usualy the worst to use. Then it goes into starting IDE.
> 
> Maybe I should just create a new page here and link that one instead. All explained there is start the IDE for first time and have a look around.
> 
> So, once someone new has read all that they should have all basic info to get started. The additional links in the 'Beginner' section are teh Learning topics and Naming conventions. Maybe a few others should be added here (like some of the once Lee mentioned), so all is easily located at one place.
> 
> If someone would take up the remaster/consolidation of the naming conventions, taht would be nice. I'll see to start on the rewrite mentioned and once that is done I'll start moving some pages to path /learn with an index. Don't expect all this to be done today ;-)
> 
> Any other suggestion, needed addition, let me know while I'm at it, or add it yourself to where you think it fits best, either as a direct link in above 'Beginners' section or as link on the still to create 'Learning topics' index page.
> 
> At least there will be some better organized and updated information for people new to Gambas.
> 
> gbWilly


Creating the 'Learning topics' page and moving all over was actually really simple and well explained by Benoit, so I've already done all that.
The old pages are still there, so are they really moved or is it a matter of waiting until all is updated?

I also created 'Getting started with the IDE' (not yet finished, I still need to add some more content to it).

With these two in place I changed order and topics in 'Beginners' section of the 'Topics' page as explained above. I replaced one of the 'naming convention' links with a 'Learning topics' link and left the other. The remaining convention page needs to be linked to this.

I added a screenshot so you get the idea of what I've done. 


gbWilly

GambOS
Gambas3 for Debian/Ubuntu

...there is always a Catch if things go wrong!

Sent with Proton Mail secure email.

Attachment: topics-beginners.png
Description: PNG image