User talk:JulienDethurens/Guide

From Legacy Roblox Wiki
Jump to navigationJump to search

Wiki Tutorial Outline

Instead of everyone writing their own guides and tutorials on pretty much the same exact concepts, I'd like there be one single structure of tutorials that everyone contributes to. I think that's what everyone is searching for, really.

I've written an outline for what I think a lua tutorial should be on the wiki. It's basically a proper implementation of the Lua Help page. What this page does right is define a structure of tutorials, ordered from most simple to most difficult. What's wrong with it is that the structure isn't well thought out, and the articles it contains don't have inter-navigation with each other. That is, there are no previous and next buttons.

This outline describes the structure and order of these articles. They're ordered based on abstraction; later articles can assume that the reader has read concepts described in previous articles. Simplicity is also taken into consideration, even if that means skipping over something and coming to it later. Ideally, a beginner should be able to traverse the articles in order, understanding everything in each article, without jumping around pages too much.

Here's the outline so far:

Outline:
Map:
Scripting Help
	Creating Scripts
		- Script Instance
		- Lua IDEs
	Pure Lua
		- Starter
			First Script
				- print
				- comments
			Variables
				- Assignment
					- Multiple assignment
				- local
				- Naming
			Data Types
				- Numbers
				- Strings
				- Booleans
				- Nil
			Expressions
				Operators
					- Arithmetic
					- Relational
					- Logical
			Statements
				Chunks and Blocks
					- More on local
				Conditional Statements
					- if
					- elseif
					- else
				Loops
					- Numeric For
					- While-Do
					- Repeat-Until
					- Break
			Functions
				- Arguments
				- Returning
					- multiple returns; relation to variables
			Tables
				- Construction
				- Indexing
				- Arrays
				- Dictionaries
				- Setting Indices
			Standard Libraries
				- string
				- math
				- table
		- Intermediate
			String Patterns
			More on Tables
				- keys: any type
			Generic For
			Operator Precedence
			Conditional assignment
		- Advanced
			Metatables
			Environments
			Coroutines
			goto (5.2)
	Lua and the Roblox API
		- Instances
			- Properties
			- Methods
			- Events
			- Callbacks
		- Roblox Data Types

Once again, the order isn't concrete. I'm thinking of introducing instances earlier on, such as teaching properties right after variables, and methods after functions. Who knows. Need to think about it some more. --Anaminus 01:38, 30 April 2012 (EDT)

Heh, your order is extremly similar to how I'm planning to order stuff for this tutorial. Pure Lua first, then add the ROBLOX API to it all. I teach about the print function and the comments first, then variables, some basic terminology and understanding and some other things.
I know there are already tutorials I could contribute to instead of writing my own, but I just don't want to contribute to them: most of them are a mess. That's why I'm writing my own from scratch, so we have a good tutorial that we can start from. The problem: every writer wants to write his own tutorial from scratch for the same reason, but none of them actually finishes it. So far, my tutorial is advancing. User:Crazypotato4/Test's tutorial is nice too. Finally, we have Camoy's Cookbook, which is full of examples that we can link to, since they're explained there. --JulienDethurens 01:47, 30 April 2012 (EDT)
I would suggest adding these two things too it, in this order, starting at the beginning:
  • Using ROBLOX's Social features / The Website (Below not necessarily in order)
    • Making Money
    • Builders Club
    • Making Stuff (Shirts, Pants
    • Group Management
    • Popularizing your place
    • Advertising
    • Making Friends
    • General discussion - Forums
    • More stuff........
  • Learning to Build on ROBLOX, with techniques
    • Techniques to position bricks
    • Using materials
    • Antilag techniques
    • How to use Studio
    • How to install plugins
    • Click and drag CFrame plugins
    • Using free models wisely
These should help kids learn how items and properties on ROBLOX work, what type of game to make how to be semi-famous, improve the community, and teach them about stuff. We slowly transist from building to scripting, teaching them how to, like, make their buildings animated and stuff. :D We also, in the beginning of social stuff, teach them about report abuse, and a few quick basics. Of course, these aren't defined sections, we blend them together. :D
Unless, of course, we still think the wiki is a API guideline booklet. - Quenty (talk • April 30)
Oh don't you worry, I have the website, studio, and API doc outlined as well. --Anaminus 04:04, 30 April 2012 (EDT)