Forum > Documentation (Maintaining -)

Wiki: Lazarus Tutorial

<< < (2/4) > >>

kupferstecher:

--- Quote from: trev on December 07, 2021, 01:25:23 am ---There is also Howdy World (Hello World on steroids) in a similar tutorial vein followed by Peg Solitaire Tutorial.

--- End quote ---
I just read these two tutorials, they are very good. If I had found them the time I started with Lazarus that would have been very helpful. I saw that you already linked them to the Tutorial, so thats very good.

My first impression when I saw these was that my tutorial perhaps just clutters the wiki more and by that is counterproductive. I think its important to have a guiding thread through the tutorials and not just having a pack of tutorials distributed over the wiki. So perhaps we can bind them more together.

In comparison to the two tutorials the one I made is quite different. I focused on basic usage of the LCL and left everything else away. Beyond the LCL stuff the calculater and solitaire tutorials describe a lot of details using the IDE and also a lot of language features are introduced, showing a real program structure (and not only a unit1 with event handlers).

My concern is that its easy to get overwhelmed by the combination of the topics. Especially with the language part, as a single procedure is much more difficult to understand, the more "real programming" it contains. On the other hand its important to learn - earlier or later - where to put ones variables in a real program and so on.

-> Any ideas how it could be possible to combine the tutorials, bringing them in a logical and useful order? Perhaps introducing them as alternative "part 2"s?


--- Quote from: af0815 on December 06, 2021, 08:57:13 pm ---I think the part begining with "Learning the language" can be extracted as a standalone part ? 3 ?
--- End quote ---

The idea was to put in a link to a language tutorial there. But I didn't check yet, what is available. As part 3 I had planned a little animation, creating controls on runtime, working on the canvas, using a timer and discussing Parent vs. Owner. Well, a lot would double with the solitaire tutorial, so...


--- Quote from: af0815 on December 06, 2021, 08:57:13 pm ---And on the start of a page should be a link to the prio and next lesson. At the end a jumptable to all the lessons. So the navigation is faster and intuitive.

--- End quote ---
Yes, that would be very good, but I feel its more difficult now as I learnd of the two (excellent) tutorials Calculator and Solitaire.

wp:

--- Quote from: kupferstecher on December 06, 2021, 06:49:44 pm ---I just added a second part to the Lazarus Tutorial on the wiki with a new page:

https://wiki.freepascal.org/Lazarus_Tutorial_Part_2

--- End quote ---
Part 2 is great. But I don't like part 1 as a "tutorial": it's just an enumeration of the menu items and a brief description what they do. But most new users of Lazarus will  not understand what they are reading here. I'd begin with the practical tutorial (now part 2) and maybe refer a bit more to the menu commands; this way the user will learn the most important menu commands in passing, and the current part 1 will be much clearer afterwards.

kupferstecher:

--- Quote from: wp on December 07, 2021, 06:05:52 pm ---But I don't like part 1 as a "tutorial": it's just an enumeration of the menu items and a brief description what they do.
--- End quote ---
Yes, in my perception only the "Getting started" section was the tutorial. And it ends with "The rest is up to you!". I actually think that section is a good starter for "part 2", as it describes how to create a project and the work with the form and event handlers, basic keys (F9,F12). So in the "part 2" these things don't need to be detailed anymore. Now I looked the page again, in the end it's getting more interesting, but it's somehow hidden behind the menu descriptions.

So I would favor to bring everything from the page [Lazarus Tutorial] except "getting started" into a new page and perhaps call it "IDE Tutorial", it could be dealt as one part of the tutorial. Or even reworked, because it really is not very tutorial like.

The getting started could be combined in one page with "part 2", but there are a lot of translations of the page, so perhaps its better to keep it seperated.

wp:

--- Quote from: kupferstecher on December 07, 2021, 07:02:07 pm ---So I would favor to bring everything from the page [Lazarus Tutorial] except "getting started" into a new page and perhaps call it "IDE Tutorial", it could be dealt as one part of the tutorial. Or even reworked, because it really is not very tutorial like.

The getting started could be combined in one page with "part 2", but there are a lot of translations of the page, so perhaps its better to keep it seperated.

--- End quote ---
Good ideas.

trev:

--- Quote ---So I would favor to bring everything from the page [Lazarus Tutorial] except "getting started" into a new page and perhaps call it "IDE Tutorial", it could be dealt as one part of the tutorial. Or even reworked, because it really is not very tutorial like.
--- End quote ---

Look at the content and you'll see:


--- Code: Text  [+][-]window.onload = function(){var x1 = document.getElementById("main_content_section"); if (x1) { var x = document.getElementsByClassName("geshi");for (var i = 0; i < x.length; i++) { x[i].style.maxHeight='none'; x[i].style.height = Math.min(x[i].clientHeight+15,306)+'px'; x[i].style.resize = "vertical";}};} ---== The Main Menu =={{:Main menu}}
The IDE Main menu help page has been transcluded into the tutorial. It is a separate page already [Main menu] and is the entry page for the many menu options accessible from the IDE Main  menu.

Perhaps it would be a better idea to simply remove the transclusion and add a page link to the content with appropriate description.

Navigation

[0] Message Index

[#] Next page

[*] Previous page

Go to full version