While AFKMud is well documented in the help file department, even more so then the source it was derived from, I see more and more requests for documentation or How-To Guides on how to do various things in the game.
My own staff, however growing, has requested documents such as this, which is leading me in the direction of writing them. I would rather not be greedy though, and I'd like to give back to the community and to AFKMud by writing guides for everyone.
So I ask you, what are you looking for in a guide?
I've already started, but I'm not sure my direction is going to be the best. I'm not sure if I should write from the stand point of myself teaching a complete newbie, or myself teaching someone who also has someone to bounce questions off of. In general, am I writing a Reference Guide (pure documentation, no real explanation of things), or a Tutorial (documentation with help, explanation and even lessons)?
I also ask the question of format. What format should this be in? Should I keep this a plain text file, or a rich-text document? Should I write it in HTML to allow easy hyper-linking between sections, or should I save it to Adobe Acrobat when I'm done?
Also, how much detail should I go into? My thought is to cover every aspect of the game's OLC. Few people understand that OLC does not just cover rooms and areas, but everything changeable online. This would then include Mud Variables, Races, Classes, Deities, Channels, and the list can go on.
Finally, how should I release it? Would you prefer that if I do go for a more complete OLC Guide that I release it as I complete sections, or that I wait until I feel it is near complete and then release it?
Your input is very much so appreciated so that I can ensure I am doing the right thing in this project. I would also love the input of AFKMud's staff. Would you support my effort and inspect what I've written to ensure it is accurate to your understanding of your project?