On Mon, 2 Apr 2001, Alex wrote: >> My question is this: How do people on this list feel about the notion >> of documenting style, calling conventions, or other _complex_ >> techniques being used in Circle, as well as in patches, snippets, etc? > >We (the CircleMUD team) have actually talked about this before and >putting in some sort of "this is how/why we are doing things this way" >document/comment/whatever into the code/distribution. I added some of that to extract_char_final(). More coming as soon as I find sticky places that should have it. >To this point, we haven't really agreed on what should be in there, so of >course, since we all have other things to do outside of the CircleMUD >environment (except maybe George... (= ), we haven't gotten around to >putting anything of the like together. I have plenty to do, it just comes in spurts. I still have to do my taxes (April 15th), two projects (April 23rd, 26th), and a bit of whatever else shows up. I'll be more free starting May 3rd, assuming work doesn't gobble all the time up. >> I also admit to some ignorance as to the state of the "coding" >> document... > >It would be something that could go in a "finished" version, but we are >nowhere near that at all (and at the rate we're going it will likely stay >that way). As such, we encourage all user submitted documentation and >when we do get around to the 'coding.doc' file, we'll likely use some of >what is submitted (in some form at least) to build the "finished" version. Requires learning LaTeX to get started on that and it really hasn't presented itself as an activity I'd have time for (yet). -- George Greer greerga@circlemud.org -- +---------------------------------------------------------------+ | FAQ: http://qsilver.queensu.ca/~fletchra/Circle/list-faq.html | | Archives: http://post.queensu.ca/listserv/wwwarch/circle.html | +---------------------------------------------------------------+
This archive was generated by hypermail 2b30 : 12/05/01 PST