I was following the instructions for the postfix set up, and there were three things which were unclear: 1) What I needed to make custom, and what was a system call to leave in. For example, in "mysql-aliases.cf", should I type in "$password" or "e2ei432" (or whatever my password was). It would be helpful to have some delineator (such as bolding) for a "pay attention, this is customized per machine" setting. 2) I don't use virtual servers, nor mailing lists. It would have been helpful for it to be more obviously marked "If you don't want virtual servers, skip to *there*" 3) For the Apache setup would have been helpful to have a quick list of things to do. Maybe extract the 5 bullet points from the guides you reference (as it took me a considerable amount of time to figure out what they were saying, especially the securing with .htaccess, which I think I still did wrong). Reproducible: Always Steps to Reproduce: 1. 2. 3.
1. Clarified the stuff on "fill in your own values/names/variables here". 2. There are already quite a few statements about "if you don't use this (such as squirrelmail), skip ahead." 3. There's an explicit warning at the beginning of the doc to read the whole thing a few times before beginning installation, to familiarize yourself with the process and so that what you'll be doing sinks in, so that you hopefully "get it". a 5-point list isn't going to help. That's more likely to confuse users; they'll wonder if they do the short stuff first and leave the long directions to the advanced uses/implementations. Bottom line, if you're having hard time changing a particular config for *your box*, the place to go is the forums, the mailing lists, the other articles referenced (we won't repeat their content here; you have to read them yourself), or on IRC. Fixed in CVS!
