Better Docs.pdf

Key Points:
+ Importance of correct, complete, concise, and easily readable documentation
+ Use of mdoc(7) markup language and mandoc(1) toolbox for BSD projects
+ Improvements to HTML/CSS output and man.cgi(8) for better presentation
+ Introduction of markdown output mode and improvements for manual pages in ports
+ Documentation of LibreSSL and API design
HTML Improvements:
+ Selection of adequate HTML elements depending on mdoc(7) macros
+ Use of "class=" attribute to save information from mdoc(7) macro
+ Embedding of minimal stylesheet in the "" element
+ Fixing of HTML syntax violations and improvement of HTML output line break and indentation logic
CSS Improvements:
+ Replacement of hard-coded HTML "style=" attributes with CSS
+ Use of CSS "@media" query to adapt indentations to physical screen size
+ Emission of "meta name=viewport" element to work around mobile browser issues
User Interface Improvements:
+ Use of real macro names as "class=" attributes
+ Use of CSS child selectors and avoidance of overqualified CSS selectors
+ Consistent use of "em" units throughout
+ Implementation of having .Bl -tag heads and bodies on the same line when they fit
* Semantic Functions:
+ Concise resource identifiers and deep linking
+ Redirect to concise URIs and implementation of "id=" attributes for deep linking
+ Dotted underline in HTML+CSS output and hover to cut and paste the URI
+ Preservation of leading comments and display of name and section number of manual page in HTML "