Policies and principles: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
mNo edit summary |
||
| Line 6: | Line 6: | ||
* Assume those who come after you aren't as expert as you, | * 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, | * 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 | * 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 | * 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 <code>conform</code>. 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. | * 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 <code>conform</code>. 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. | ||
Revision as of 07:06, 23 Haziran 2022
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