by Cryptonomic » Fri Jan 14, 2005 8:58 am
Hugella wrote:The whole Hugonomicon project started from the desire to see better user documentation/resources, especially for beginners. It'd be ideal to one day produce something along the lines of the IBG or Eric Eve's 'Getting Started With TADS 3'.
I agree. That is part of what I wanted to start with the idea of a tutorial format. I have since been rethinking a little about how I did the tutorial. What I would like to do now is actually start more with classes. Then show deriving object types from those classes. That would lead to, perhaps, room types. Then I would focus on the directions between rooms. I would not go off on tangents, as I did in my first attempt, but rather save the tangents for later parts -- adding to the already existing code base.
Further, beyond the full-scale assault of a tutorial, I think of Roger Firth's page for Inform (specifically the InFact, InFancy, etc, sections). Those are sort of focused "lessons", if you will, into the specifics of Inform. I think Hugo might benefit from something like that as well.
The tutorial(s) could then reference those "lessons" and even the tips and tricks can point to parts in the tutorial where the tip or trick is used in a full example.
Further, I think getting the Hugo Manual in a Web-based format would be good. Not a direct conversion; rather, a true porting of the manual into HTML, with images to perhaps clarify some concepts (like parent/child hierarchies). Then tutorials, tips/tricks, and lessons could all reference the relevant section in the now on-line manual.
Again, these are all just thoughts piddling around in my mind so treat them with the grain of salt they probably deserve. The goal (for me) is to attract more people to Hugo initially; to give Hugo the "spit and polish", as it were, that these languages seem to need in terms of ancillary or supporting material so that people will be drawn to the language and see it is a viable alternative. Eventually I could see HugoComps or something following from that.
- Jeff
[quote="Hugella"]The whole Hugonomicon project started from the desire to see better user documentation/resources, especially for beginners. It'd be ideal to one day produce something along the lines of the IBG or Eric Eve's 'Getting Started With TADS 3'.[/quote]
I agree. That is part of what I wanted to start with the idea of a tutorial format. I have since been rethinking a little about how I did the tutorial. What I would like to do now is actually start more with classes. Then show deriving object types from those classes. That would lead to, perhaps, room types. Then I would focus on the directions between rooms. I would not go off on tangents, as I did in my first attempt, but rather save the tangents for later parts -- adding to the already existing code base.
Further, beyond the full-scale assault of a tutorial, I think of Roger Firth's page for Inform (specifically the InFact, InFancy, etc, sections). Those are sort of focused "lessons", if you will, into the specifics of Inform. I think Hugo might benefit from something like that as well.
The tutorial(s) could then reference those "lessons" and even the tips and tricks can point to parts in the tutorial where the tip or trick is used in a full example.
Further, I think getting the Hugo Manual in a Web-based format would be good. Not a direct conversion; rather, a true porting of the manual into HTML, with images to perhaps clarify some concepts (like parent/child hierarchies). Then tutorials, tips/tricks, and lessons could all reference the relevant section in the now on-line manual.
Again, these are all just thoughts piddling around in my mind so treat them with the grain of salt they probably deserve. The goal (for me) is to attract more people to Hugo initially; to give Hugo the "spit and polish", as it were, that these languages seem to need in terms of ancillary or supporting material so that people will be drawn to the language and see it is a viable alternative. Eventually I could see HugoComps or something following from that.
- Jeff