BIND 10 #3020: document b10-auth static.zone

[BIND 10 Development]

#3020: document b10-auth static.zone
-------------------------------------+-------------------------------------
            Reporter:  jreed         |                        Owner:  jreed
                Type:  defect        |                       Status:
            Priority:  medium        |  reviewing
           Component:                |                    Milestone:
  documentation                      |  Sprint-20130806
            Keywords:                |                   Resolution:
           Sensitive:  0             |                 CVSS Scoring:
         Sub-Project:  DNS           |              Defect Severity:  N/A
Estimated Difficulty:  3             |  Feature Depending on Ticket:
         Total Hours:  0             |          Add Hours to Ticket:  0
                                     |                    Internal?:  0
-------------------------------------+-------------------------------------
Changes (by muks):

 * owner:  UnAssigned => jreed


Comment:

 Hi Jeremy

 Replying to [comment:5 jreed]:
 > It looks like the installed share/bind10/config_plugins/datasrc.spec
 > defaults to enabling the static.zone.  We need to explain why to
 > re-configure it and how to disable.

 I think the section before the newly added static data source section
 and the newly added section describe it enough now.

 > I think the docs need to state what the static.zone is:
 >
 > BIND 10 provides a zone file for the CH (Chaos) class for providing
 > information about the server via the AUTHORS.BIND and VERSION.BIND TXT
 > records.

 This has been added now.

 > I assume later could be used for other builtin CH.  So I even think
 > the name "static.zone" is wrong.

 We can rename this file if necessary.

 > The examples are strange with:
 > {{{
 > config add data_sources/classes CH
 > config commit
 > config add data_sources/classes/CH
 > }}}
 > If that above is correct, then it is quite confusing. Why does one have
 a space and one has a slash?

 Michal has explained this in the last comment.

 > By the way, the static.zone file has a confusing comment suggestion to
 > run in bindctl: loadzone CH BIND (which does not work).

 This heading comment has been updated.

 > The dig examples assume localhost. Maybe mention that. And the prompt
 > may be confusing since matches the prompt from previous example (Unix
 > shell versus bindctl).

 This has been described now in the adjacent doc.

 > I pushed one minor fix: 7915732b2210e5540a74041eb759b13af0f6c405

 This look good.

-- 
Ticket URL: <http://bind10.isc.org/ticket/3020#comment:7>
BIND 10 Development <http://bind10.isc.org>
BIND 10 Development