So... I've finally decided to get around to revisiting my tutorial, which I know is not very user friendly. The goal for me is to create a friendly, easy to follow guide on how to use Quest from the most basic to the most advanced (at least as advanced as I can get). It will be focused on using the GUI and not so much writing your own code, although there will inevitably be references to that.
My current plan is this. Create small 'publications' with specific topics. For example, the first one I decided to tackle was "All About Objects". Here, there are currently 6 different rooms that progressively get more complex as the user travels south.
The rooms in order from most northern to southern are: Room 1. Naming objects. Focus: 'naming objects' and 'using aliases' and 'other names' Room 2. All About Object Tabs. Focus: all the tab essentials Room 3. Visibles and Invisibles. Focus: making objects seen or unseen in a room. Very handy! Room 4. Objects that Can Be Switched On/Off. Focus: Being able to turn on and off objects like TVs and Radios! Room 5. Combining Objects. Focus: Combining two or more objects to make new objects. Room 6. Using Objects on Other Objects. Focus: Lots of Easy scripting and Complex Scripting. Depends on what you want to do!
I plan on creating similar tutorials for other areas of Quest as well. The current list of those areas are basically the major scripts:
Adding and Managing Attributes
Using Commands and Verbs
Adding Sounds and Images, and changing Text and Font options
Light and Dark Options
Player Health and Player Score
Edibles and Clothing
Creating Exits and Teleporting/Transportation of Player and Objects
NPC Communication and Give, Tell, Ask
Handling Player Input - Menus, Switch Scripts
Outputting Random Responses
Turnscripts and Timers
Text Processor Commands
The last two things on my list I think would be helpful, but I have not worked into any of my games yet.
Please advise if there is anything that you think might be helpful, whether it is content, organization, layout, etc. I'm happy to solo this thing (it helps me learn=) as a lot of the descriptions and scenarios are already written, but if anyone wants to contribute, especially in the areas in which I am weak, I would welcome it.
sounds good, keep up the awesome work XanMag!
I'd just recommend also getting to this too when you can include it into your tutorial (not sure if it should be combined with another topic such as Turnscripts+Timers, or as a separate topic in of itself):
the special 'changed' Script Attribute is really useful for people to know about too
also the 'parent' Object Attribute is useful for people to know/understand about too, but you're probably already going to cover this in one of your topics.
As a suggestion, you might consider grabbing a few friends that know nothing about quest, and having them fire questions at you while they try to figure it out without any instructions to read. Jot all the questions down and then work up lessons to deal with them.
Thankfully (sort of), I am a teacher and I probably could convince our "computers" teacher to work this in near the end of the year. Use Quest as a learning tool for programming AND help me out with the tutorial along the way! =)
For my introduction to Quest Tutorial I am "simply" discussing all the tabs and what they do.
Hierarchy of input:
My options for set-up/lay-out, as I see them, are:
I am leaning toward option 3, as it considers those who prefer typing and those that prefer clicking AND it seems like the least messy of the bunch. Any ideas/input on this is greatly appreciated!