Im starting a QDK tuturial.this is all i have so far,and i started it about half an hour ago:

' "QDK tuturial"
define game <QDK tuturial>
	asl-version <350>
	gametype singleplayer
	start <1st room>
	game author <Francis Robert Stokes>
	game info <TUTURIAL>
end define

define synonyms
end define

define room <1st room>
	alias <Quest Tuturial!>
	prefix <the>
	look <Everyone loves games,right?Hey,if you didn't,then you wouldn't have downloaded |clquest|cb!|nThere are some things that you should know before we start.Firstly,a good game needs alot of hard work,and everyone is tempted to put their game out there straight away but you need to finish it!|nThis tuturial will be split into sections, like rooms, objects, variables, script etc...|nOk then!Lets proceed.....>
	indescription <Hello and Welcome to:>
	north <2nd room>
end define

define room <2nd room>
	alias <Starting up,eh!>
	place <**New Game Wizard**> goto <**New Game Wizard**>
	description <|c|jc|b|u|iSECTION ONE:Making A Game|xi|xb|xu|n|jl|nIn this section,Your going to find out about how to set up a new game, make rooms and make objects.>
end define

define room <**New Game Wizard**>
	look <Ah!I see that you have chosen how to set a new game with the wizard.Open QDK and press the ok button on the tips,We'll look at those later.|nClick on the sheet of paper icon on the top let and this will bring up the wizard.Click next as you are going to make a single player game at the moment.In the next page,you have to name your game.I can't do this bit for you so you decide on a name.The next box (the "Your Name" box),is quite simple....you can work it out.After that is a box for where you want to save the file.Click browse and put it my documents.You can move it later.Click next.|nYou don't have to worry about the next page at the moment so click next again.|nThis page is the rooms page.In the box type startroom so you know that it is the room you have to start in.After your done,click add and check the box.This will set your room as the start room.Click finish.|nWell done!You have just set up your game and added a room.The game is now playable...well,theres nothing in there yet,but,hey!|nType back to go back to section 1.>
	command <back> goto <2nd room>
end define

define text <intro>

end define

define text <win>

end define

define text <lose>

end define

Please tell me what you think.

Perhaps just writing a tutorial in a text document, PowerPoint or something would be easier to follow, but the writing seems okay.

Actually, because of the way ASL is - it isn't an actual programming language, and has certain blocks that need to be there.

I'd say go for many different files - or at least additional libraries - which add to the game, otherwise you'll find a big file showing off all the abilities of quest, but hard to explain because it's so big and complex.

In normal programming there's only one direction - down.... You may go off and do functions, but usually you just go down.
In ASL you're hanging in one room, then off to another, doing various code at various times - just harder to explain.

All i was planning this to be for was a little "Quick Start" help guide,so that a beginner can start making a game straight away.
It only has 1 section so far,and thats not finished,but i was only going to make 3 or 4 sections so the player could read this,mabey taking them 5 minutes,and start making a game.
I do see what you are saying though,Computer Whizz.