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