IMO the best manual is the one you can understand best of all.
I mean that if you're making a game (or learning from an example) you get it much better and it stays pretty clear for a while. But you should understand the whole procedure (algorithm).
Any programming (obviously but macro) is a detailed step-by-step instruction for PC.
For example, you need 'Send the letter' action for your robot, but if you just:
CODE
move_towards(post.x ,post.y , 5km_per_hour); //go the post-office;
if reached {
do {
_MBX=instance_nearest(x, y, MBX); //find the nearest MBX;
} until _MBX> noone;
_MBX.letter=letter; letter=noone; //drop the letter into the MBX
move_towards(home.x ,home.y , 5km_per_hour); //return home
}
if reached {plug_for_recharge(); game_end()} //at home
- it will go
straight there braking cars and structures, pushing people, can get caught in an endless loop and so on. So you need to give it a more precise definition followed by more and more instructions for
ANY expected situation...