by Roody_Yogurt » Tue Jan 03, 2012 1:29 pm
First off, thanks for all of the work on HxE. I especially like the “declarations” category. While not explicitly called that in the Hugo Book, that should help newcomers understand the construction of a Hugo file a bit better. Also, I had avoided making a category (and individual pages) for attributes in the past- as I didn’t think there was a lot to be said about any particular attribute- but creating one is probably a wise move in the long run, as there are some tricky special cases that could be elaborated on.
That said, I do have some reservations about some other things:
The globals page incorrectly implies that you can set one global to several values. You can only declare one initial value, if any. Actually, looks like the local variables page says it, too.
The “routines” section of the Introduction page implies that player.name usually holds the player’s actual name in it. In most games, the player object’s name property is “you”. In first person games, it’s “I”.
Also, in that same section, the “size” property is misrepresented. The size property is used for determining whether things fit into containers or are take-able. The example implies that it is used for actual lengths. Plus, it should be “print number table.size”, not “print table.size”.
Your “handler” pages describe what the Hugo Book (and Hugo code itself) refers to as “verb routines.” Hugo by Example is not meant to explain programming concepts to people; it’s supposed to complement the Hugo Book. Introducing completely new terminology like that is just going to confuse people.
The introduction page also shouldn’t speculate on why someone is using Hugo. I mean, some of us (like myself) use it just because we find it to be a nice mix of readability and program-y. Saying that it’s particularly used for multimedia games is somewhat presumptuous.
The Verbs page should probably link to the “grammar tokens” page, as that goes into detail about all of the various grammar tokens (even the more obscure ones).
That all said, I think things are off to a nice start!
First off, thanks for all of the work on HxE. I especially like the “declarations” category. While not explicitly called that in the Hugo Book, that should help newcomers understand the construction of a Hugo file a bit better. Also, I had avoided making a category (and individual pages) for attributes in the past- as I didn’t think there was a lot to be said about any particular attribute- but creating one is probably a wise move in the long run, as there are some tricky special cases that could be elaborated on.
That said, I do have some reservations about some other things:
The globals page incorrectly implies that you can set one global to several values. You can only declare one initial value, if any. Actually, looks like the local variables page says it, too.
The “routines” section of the Introduction page implies that player.name usually holds the player’s actual name in it. In most games, the player object’s name property is “you”. In first person games, it’s “I”.
Also, in that same section, the “size” property is misrepresented. The size property is used for determining whether things fit into containers or are take-able. The example implies that it is used for actual lengths. Plus, it should be “print number table.size”, not “print table.size”.
Your “handler” pages describe what the Hugo Book (and Hugo code itself) refers to as “verb routines.” Hugo by Example is not meant to explain programming concepts to people; it’s supposed to complement the Hugo Book. Introducing completely new terminology like that is just going to confuse people.
The introduction page also shouldn’t speculate on why someone is using Hugo. I mean, some of us (like myself) use it just because we find it to be a nice mix of readability and program-y. Saying that it’s particularly used for multimedia games is somewhat presumptuous.
The Verbs page should probably link to the “grammar tokens” page, as that goes into detail about all of the various grammar tokens (even the more obscure ones).
That all said, I think things are off to a nice start!