BIND 10 #3006: Import datasource design documentation into BIND 10 git repo

BIND 10 Development do-not-reply at isc.org
Mon Jun 24 17:11:40 UTC 2013


#3006: Import datasource design documentation into BIND 10 git repo
-------------------------------------+-------------------------------------
            Reporter:  muks          |                        Owner:  muks
                Type:  task          |                       Status:
            Priority:  medium        |  reviewing
           Component:                |                    Milestone:
  documentation                      |  Sprint-20130625
            Keywords:                |                   Resolution:
           Sensitive:  0             |                 CVSS Scoring:
         Sub-Project:  DNS           |              Defect Severity:  N/A
Estimated Difficulty:  0             |  Feature Depending on Ticket:
         Total Hours:  0             |          Add Hours to Ticket:  0
                                     |                    Internal?:  0
-------------------------------------+-------------------------------------

Comment (by jreed):

 Replying to [comment:7 vorner]:

 > I don't think we necessarily need to use the same tool. After all, these
 are two similar but different tasks. User documentation needs something
 else than developer documentation.
 >
 > With developer documentation, the formatting quality and such can be
 significantly lower. It doesn't have to impress. It is enough to be just
 readable. On the other hand, the developer documentation must be easily
 and fast editable, which docbook is far away from that. So it makes sense
 to me to use different tools for different kinds of documentation.

 There is a misunderstanding here. My comment was not about docbook and not
 about user documentation.

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


More information about the bind10-tickets mailing list