So I’ve been thinking. And this is just a suggestion. It would be a great thing, I think, to have a directed help wiki for i7.
The documentation in the IDE is awesome, but is undirected. That is, the headings focus on topics : Things, Kinds, Text, Rulebook…etc… and this is brilliant and necessary - but it makes it hard to, when you don’t know how to do something, work out exactly where you need to look for the answer. I want to stop printing a paragraph about an NPC. Do I look at the Other Characters recipe book section? Do I look at the Rulebooks section? Do I look at the Advanced Text section?
There has been an attempt to create a help forum, which didn’t take off and has been archived.
My suggestion is for a directed I7 help wiki. That is, the vast majority of people using I7 are writing Interactive Fiction. So the wiki would look like:
I want to:
- Create a room
- Create an object
- Change the room description
- Stop the banner text from printing
- Create an NPC
- Have the NPC follow me about
- Have the NPC respond to basic commands
etc…directed…not focussed on abstractions like ‘kind’ or ‘thing’
There is a commonality for a lot of the problems newbies (and experienced) developers have, and it feels like willing members of the community could contribute example code, text, and help to a wiki in a directed form based on questions posed in this and other forums,
This is just a thought…what is the general feeling?
Maybe such a thing exists and I don’t know about it!