Feedback

The adv3Lite library has now been quite a few releases, during which several new features have been added and bugs fixed. Although many bugs have been identified and corrected, it would be surprising if none remained. It may also lack some features that at least some game authors would like to see, or it may do something that some people might wish it did differently. Although it is now too late for any radical changes to adv3Lite (such as would undermine backwards compatibility with existing game code, for example), it is never too late for suggestions for improvements that might make it into some future version.

That feedback can take one of two forms: a bug report or a feature request. Sometimes the line between the two can be a bit blurry, but in general if you get a run-time error from the library, or a program crash, or the library doesn't work in the way described in this manual (or how you might reasonably expect it to behave given what this manual says), it's a bug, and your feedback will be in the form of a bug report (for reporting purposes, a typo or other obvious error in this manual can also be treated as a bug). Otherwise, it's probably a missing or less-than-optimally implemented feature, and your feedback will be a feature request.

Bug Reports

If you encounter a bug in the adv3Lite library probably the best thing for you to do is to send me an email (eric dot eve at hmc dot ox dot ac dot uk) or post on the TADS authoring section of intfiction.org with the following information:

1. The general nature of the bug (e.g. Trying to Take an object from a closed container causes a run-time error).
2. The precise circumstances under which the bug occurred.
3. The steps needed to reproduce the bug.
4. Ideally, a code snippet that illustrates the bug and allows someone (i.e. me) to reproduce it.

If you send me a bug report that's too vague (e.g. "Conversation system is buggy!!!") I can't do anything with it; I can only fix bugs if I can pinpoint them, so please do your best to help me pinpoint any bugs you encounter.

Feature Requests

The adv3Lite deliberately omits several of the features of the adv3 library (otherwise it wouldn't be a Lite version and it wouldn't achieve any simplification), so in the main there may be little point in requesting the addition of features that would simply turn adv3Lite into a clone of adv3; if you need the full complexity and sophistication of the adv3 library for a particular project, then the adv3 library is probably what you should use. That does not mean, however, that I regard the feature set of adv3Lite as entirely closed. Indeed, I'd like to hear the ideas of people who are testing, using or trying out the system. I certainly don't guarantee to implement every feature that's requested, not least because I want to keep this as adv3Lite, but I'm likely to be particularly sympathetic towards requests that fulfil one or more of the following criteria:

1. The lack of the feature is a serious hindrance to people who might otherwise want to use the system.
2. The gain in functionality that would arise from adding the feature clearly outweighs any resultant increase in complexity.
3. The current implementation proves awkward to use in some particular and the proposed new feature (or modified feature) would clearly alleviate the problem.
4. The proposed new feature would result in greater ease of use.

On the one hand, I am most unlikely to accept requests to add back features that I have deliberately omitted from the adv3 library, such as real-time processing and the transcript. On the other I may consider implementing any substantial new features as further extensions rather than as additions to the core library.

You are, of course, welcome to email me with any feature requests you may have, but it may be more fruitful to post your thoughts to the TADS authoring section of intfiction.org so that other people can see them and discuss them.