[documentation] Multi site docs feedback

[Anton]

On 09/10/06, Anisa <mystavash at animecards.org> wrote:
> OK, I got it!  But, I don't know that I agree.  Well, I agree that Step 3 is
> the crucial hard part, and not many people know there IS a step 3 (since
> it's not mentioned in the install.txt *ahem!*).  But there's a bit of trial
> and error involved, whereas the database is (for your average install)
> straightforward, and you don't have too many places to go wrong in the
> settings.php file.  I think it would confuse the issue more to go backwards.
>
> It's not like we're stopping them from skipping to step 3.  :)

My main point is that if you try to configure the database or the
sites directory first - you have no way of testing whether or not you
did it properly as you need the pointing stuff working to be able to
test it. It is like a prerequisite step for multisite.

If you configure the pointing step first, you can test whether or not
that step was done right before adding other variables to the
equation.

An important troubleshooting technique (for anything) is breaking
things down into individual testable parts and only changing one thing
at once.

Without that, you have too many variables to try at once and
troubleshooting just ends up as random guesswork or voodoo.

-- 
Cheers
Anton