BIND9 is very well documented with the BIND9-ARM. I keep a browser bookmark to it, and I refer to it quite often. I can always find what I am seeking.
But, as with most things, improvement is possible. :) Chapter 6 is the comprehensive configuration reference. What I'd like to see is more (and plain-language, consistent) hyperlinking. The basic idea is that any named.conf setting could be found at an anchor: Bv9ARM.ch06.html#that-setting And anywhere that it appears in the ARM, there would be a hyperlink to "Bv9ARM.ch06.html#that-setting". Similarly, configuration file elements could be linked as "Bv9ARM.ch06.html#that-element". It also would be nice to change the many existing "id25xxxxx" anchor names into plain language names, such that given the URL with anchor, you'd know what to expect. The idea comes from Postfix MTA's superb postconf(5) manual: http://www.postfix.org/postconf.5.html This sounds grand and relatively simple, but in practice it will require some thought and work. For example, we have "Grammar" and "Definition and Usage" subsections for each "Statement" section. Which one would we link to? Ideally, both, but we'd have to think about a good anchor naming scheme. I'd say that the name in each "Grammar" should hyperlink to each "Definition and Usage" name and vice versa. Also, what do we do in the case where the same setting is usable in more than one context? Looking at "Zone Options", with numerous "See the description of ...", this would actually help, because it would take you directly to the setting rather than to the subsection heading. Looking at the HTML source for the Table of Contents, it seems like someone had this idea before but didn't follow through. There are numerous links to plain-language anchors amidst mostly the "id25xxxxx" anchor names. (These probably had something to do with the "DocBook XSL Stylesheets V1.71.1" generator.) I might try to work on this myself, but I thought I should toss the idea out for comments and suggestions first. Specifically, I suppose that whatever work that is done should be compatible with the DocBook source and other BIND9-ARM formats. -- http://rob0.nodns4.us/ -- system administration and consulting Offlist GMX mail is seen only if "/dev/rob0" is in the Subject: _______________________________________________ Please visit https://lists.isc.org/mailman/listinfo/bind-users to unsubscribe from this list bind-users mailing list bind-users@lists.isc.org https://lists.isc.org/mailman/listinfo/bind-users
