Date: Fri, 6 Jul 2018 22:06:39 +0200 From: Sid <sid@bsdmail.com> To: freebsd-doc@freebsd.org Subject: Documentation should rely on stylesheets for XML not txt tools Message-ID: <trinity-c501607c-707c-4784-b4d9-305e2a9be537-1530907599794@3c-app-mailcom-lxa11>
next in thread | raw e-mail | index | archive | help
For spacing and presentation, FreeBSD documentation should rely on style sheets for XML, not on txt tools. XML is made for stylesheets to take care of its presentation. The requirement for improving documentation should be to learn XML and Docbook schema, and not other heavy (text based) tools that get in the way. Let a program take care of spacing that is outside of XML element tags. Text based tool igor doesn't cut it. Whenever an improvement is suggested for documentation at FreeBSD's bugzilla, it sits there for months or even over a year. Parts of the Handbook are outdated, and it seems like FreeBSD's bugzilla Documentation section is understaffed. For improvements to be made, the process must be simplified, and XML must be used how it is made to be used for simplification of that process. Igor and other text based tools add more overhead, more room for errors, more errors to correct (that are not based on Syntax, definitions, spelling errors, XML nor Docbook schema), many times more work, and it makes the work of contributors more difficult. Parts of the FreeBSD Handbook are outdated, and at this rate, this will not help expand FreeBSD's user base. Thank you
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?trinity-c501607c-707c-4784-b4d9-305e2a9be537-1530907599794>