Recent

Author Topic: Tutorial page web/wiki  (Read 1857 times)

Handoko

  • Hero Member
  • *****
  • Posts: 3357
  • My goal: build my own game engine using Lazarus
Tutorial page web/wiki
« on: January 25, 2020, 08:18:18 pm »
~off topic~

@Martin_fr

May I suggest a section for short demos? I saw people often wrote demos for answering question in the forum. Some of them are short but interesting, should be shown to the public. I think they will be attractive for newbies.

For examples:

Move shape with mouse by mousemove by furious programming:
http://forum.lazarus.freepascal.org/index.php/topic,43376.msg303582.html#msg303582

Drawing, moving and make connection between shapes by Handoko:
http://forum.lazarus.freepascal.org/index.php/topic,41036.msg284131.html#msg284131

A simple pong game by Handoko:
http://forum.lazarus.freepascal.org/index.php/topic,42439.msg297949.html#msg297949

There are lots of them, but I forget where they are.

Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 5963
    • wiki
Re: Tutorial page web/wiki
« Reply #1 on: January 25, 2020, 08:26:52 pm »
I haven't checked if we already have something or not.

But to start with, maybe a tutorial page overview on the wiki? Maybe even as a portal https://wiki.lazarus.freepascal.org/Category:Portals ?
Then create individual wiki pages for each of them, or link to the forum.

The page could be linked from the home page, in the "Education" section.

This is already linked on top of the home page https://wiki.freepascal.org/Lazarus_Documentation#Lazarus_and_Pascal_Tutorials
Could be somehow integrated and the link adjusted.....

Handoko

  • Hero Member
  • *****
  • Posts: 3357
  • My goal: build my own game engine using Lazarus
Re: Tutorial page web/wiki
« Reply #2 on: January 25, 2020, 08:31:08 pm »
I meant to put them on the Lazarus website. I think newbies / new comers are not likely to visit the wiki.

Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 5963
    • wiki
Re: Tutorial page web/wiki
« Reply #3 on: January 25, 2020, 08:51:37 pm »
I meant to put them on the Lazarus website. I think newbies / new comers are not likely to visit the wiki.

It wouldn't be a problem to add a page, if someone creates and maintains it.
But the latter is kind of the issue => it needs maintenance. Even with a volunteer, there would then be only one person to integrate the updates. (And people would need a way to reach that person)

Currently we have the "online tutorials" link on the website. (It's in the top section, no scrolling needed). That should be easy to find.

The problem is => the wiki page to which it points needs a maintainer.
If it gets reworked, and made to look like the portal pages then new users would probably use it.

Look at https://wiki.lazarus.freepascal.org/Portal:Windows => that page invites to stay.


As for doing more on the website....

If someone does the work, we can add one new page "Help",  "First steps" or "Docs and info" or ......

But I do not think this page should actually hold the content (i.e. list of tutorials) => that changes. And people who want to add new tutorials should be able to do that and add them.

So what could be on the page is like a directory of help pages. Link to the online help and what to expect from the help, link to one or more wiki portals, and what to expect to find there.

I suggest various groups of links into the wiki (mainly to portal pages)
install/setup
first step creating and apps / tutorials
OS specifics
....

If we put all those links on one (sub-) page, rather than having them strewn all over the main page, that might indeed be helpful.

What do you think?



Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 5963
    • wiki
Re: Tutorial page web/wiki
« Reply #4 on: January 25, 2020, 08:56:31 pm »

trev

  • Sr. Member
  • ****
  • Posts: 402
  • Former Delphi 7 and Delphi 10.2 User
Re: Tutorial page web/wiki
« Reply #5 on: January 25, 2020, 10:47:34 pm »
But to start with, maybe a tutorial page overview on the wiki? Maybe even as a portal https://wiki.lazarus.freepascal.org/Category:Portals ?

Portals are fantastic concepts which thematically gather together all the scattered and otherwise difficult to find Wiki pages. Unfortunately the Portal pages suffer a similar fate of being scattered and difficult to find.

Can we please add the Portal page galleries which serbod prototyped at https://wiki.lazarus.freepascal.org/SANDBOX to the Main Page? At the moment none of these can be found from the home page.

If noone else takes it up in the near future, I'll also look at creating a Tutorials portal which is not a small undertaking - there are already a lot of tutorials in the Wiki, from programming AVR microcontrollers to adding an Apple Help book to an application. See: https://wiki.lazarus.freepascal.org/Category:Tutorials
o Lazarus v2.1.0 r62452, FPC v3.3.1 r42644, macOS 10.14.6 (with sup update), Xcode 10.3
o Lazarus v2.1.0 r61574, FPC v3.3.1 r42318, FreeBSD 12.0 (Parallels VM)
o Lazarus v2.1.0 r61574, FPC v3.0.4, Ubuntu 18.04 (Parallels VM)

Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 5963
    • wiki
Re: Tutorial page web/wiki
« Reply #6 on: January 25, 2020, 11:16:49 pm »
Regarding the image portal links for the main page:
I sent out a mail to the other team members. Just to make sure there is nothing about the main page that I am unaware of.

If there is not, I will take care of it in a bit.

GAN

  • Sr. Member
  • ****
  • Posts: 265
Re: Tutorial page web/wiki
« Reply #7 on: January 25, 2020, 11:17:12 pm »
A section with examples or "how to" would be interesting. I agree with @handoko, there are very good demos attached in the forum messages.
Lazarus 1.8.4 FPC 3.0.4 Linux Mint Mate 17.2 x86_64 GTK-2
Zeos 7.1.3 - Sqlite 3.8.2

Foro Lazarus en español http://forum.lazarus.freepascal.org/index.php/board,73.0.html

vladimirr

  • New Member
  • *
  • Posts: 20
Re: Tutorial page web/wiki
« Reply #8 on: January 25, 2020, 11:41:10 pm »
Quote from: Handoko
May I suggest a section for short demos? I saw people often wrote demos for answering question in the forum. Some of them are short but interesting, should be shown to the public. I think they will be attractive for newbies.

Good idea! It will be useful to have a collection of good quality demo applications!

Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 5963
    • wiki
Re: Tutorial page web/wiki
« Reply #9 on: January 25, 2020, 11:52:01 pm »
Just to mention, on top of the tutorial links in previous posts of this thread, we also have
https://wiki.lazarus.freepascal.org/Projects_using_Lazarus
https://wiki.lazarus.freepascal.org/Lazarus_Application_Gallery

vladimirr

  • New Member
  • *
  • Posts: 20
Re: Tutorial page web/wiki
« Reply #10 on: January 26, 2020, 12:01:00 am »
Quote from: Martin_fr
Just to mention, on top of the tutorial links in previous posts of this thread, we also have
https://wiki.lazarus.freepascal.org/Projects_using_Lazarus
https://wiki.lazarus.freepascal.org/Lazarus_Application_Gallery

By the way, how I can add my application to these lists?

Martin_fr

  • Administrator
  • Hero Member
  • *
  • Posts: 5963
    • wiki
Re: Tutorial page web/wiki
« Reply #11 on: January 26, 2020, 12:07:38 am »
By the way, how I can add my application to these lists?
Top right of the wiki page: register.
Once registered you can edit (most) pages.

dbannon

  • Hero Member
  • *****
  • Posts: 894
    • tomboy-ng, a rewrite of the classic Tomboy
Re: Tutorial page web/wiki
« Reply #12 on: January 26, 2020, 04:09:55 am »
Too right !  I really like the idea of a wiki page listing pointers to smaller tips and trick, demos etc in the forum. 

Maybe its a good idea if when someone adds the forum link to the wiki page, they also post a message to the forum thread saying "I just added this to XXX wiki page". That way, people, especially ones looking for those little demos, will be aware of the wiki page.

Davo
Lazarus 2, Linux (and reluctantly Win10, OSX)
My Project - https://github.com/tomboy-notes/tomboy-ng