Policies and principles

From techdocs
Revision as of 07:24, 23 Haziran 2022 by Plinich (talk | contribs) (Plinich moved page Policies to Policies and principles without leaving a redirect)
Jump to navigation Jump to search

Design and implementation

In all design and implementation choices:

  • Prefer obviousness over cleverness, even if longer or more complex,
  • Assume those who come after you aren't as expert as you,
  • If there's the remotest possibility that it may be misunderstood, add comments,
  • Bad grammar, bad spelling, bad punctuation and/or bad layout are better than no documentation,
  • Install the minimum software and configuration on a host or server to achieve desired functionality. This increases security and decreases maintenance. In particular, hosts which don't need user-login capability shouldn't have it configured, and hosts which don't need particular functionality or software shouldn't have it installed,
  • Following on from the previous point, this project is an opportunity to get rid of cruft which has accumulated over more than 20 years of life with conform. As such, yours truly (Peter), is going to make a concerted effort to say no to as much as possible to things being included — software, configuration, accounts, hosts, etc.

Otherwise:

  • Design
  • Setup
  • Implementation
  • Separating old and new
  • Operation

Grab-bag of unsorted notes

Also refer to DNS for usage policy for the different DNS domains