In praise of Apache documentation
2nd March 2004
I spent much of today upgrading a distinctly hairy Apache 1.3 server to Apache 2.0 as part of a routine OS upgrade. It certainly wasn’t plain sailing—I still have a few crinkles to iron out—but that’s more down to the weirdness of the existing configuration than any problems with Apache 2.
Apache 2 is a beautifully designed piece of software. The documentation is superb—the migration guide proved invaluable but the real gem was the directive quick reference. Armed with the quick reference and Firefox’s Type Ahead Find the previously inpenetrable httpd.conf file becomes a living tutorial on the wild and wonderful ways of Apache configuration. A wise old sysadmin once told me that the best way of learning Linux is to ls /bin and run man <command> for every command in there—then do the same thing for /sbin, then /usr/bin and so on until you run out of things to read. The same appears to be true of Apache configuration directives.
More recent articles
- Weeknotes: datasette-enrichments, datasette-comments, sqlite-chronicle - 8th December 2023
- Datasette Enrichments: a new plugin framework for augmenting your data - 1st December 2023
- llamafile is the new best way to run a LLM on your own computer - 29th November 2023
- Prompt injection explained, November 2023 edition - 27th November 2023
- I'm on the Newsroom Robots podcast, with thoughts on the OpenAI board - 25th November 2023
- Weeknotes: DevDay, GitHub Universe, OpenAI chaos - 22nd November 2023
- Deciphering clues in a news article to understand how it was reported - 22nd November 2023
- Exploring GPTs: ChatGPT in a trench coat? - 15th November 2023
- Financial sustainability for open source projects at GitHub Universe - 10th November 2023
- ospeak: a CLI tool for speaking text in the terminal via OpenAI - 7th November 2023