Things I have learned - Part 2

Systems should be silent, unless they have something important to say that requires action on the part of the system administrator. In particular, notifcations (e.,g. e-mails, but potentially other mechanisms) should only be sent if they require action. If the action required is not completely obvious from the direct contents of the notification, then you need to add a link to external documentation detailing what needs to happen (e.g. a "trouble code", or a link to your wiki etc).

Things I have learned - Part 1

I've been a system administrator for nearly 10 years now, and there's a few things I've learned along the way. This is the first in a series of short posts sharing some of these things.

Hey look - Drupal!

Hey look, I've got Drupal now.

It's one of the technologies we use at work, that I actually end up supporting (from a sysadmin perspective) for the clients I spend most of my time on. Also, it's "Not Joomla", and "Supports PHP 5.3".

And I'm sure I'll be tinkering for a while; soooo many knobs to tweak.

Tags: 

Documentation

Documentation. Supposedly the bane of every programmer, system administrator, or techie person who'd rather be Doing It than Writing About It. Those same people are also the first to complain about any lack lustre documentation of technology they're trying to use, once again proving that irony is not dead. Therefore, I'm going to complain some more, because it might make me feel better, and because I think I've got something else to say along the way.

The short version of my argument is this: if it's not documented, it may as well not exist.

Pages

Subscribe to stroppykitten.com RSS