[documentation] Multi site docs feedback

[Anisa]

On 10/9/06, Anton <anton.list at gmail.com> wrote:
>
> 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.


How?

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.
>
>
Tell ya what, before discussing which step goes first, let's get all the
stuff down.  I'm not seeing anyone else offer up documentation for this,
which I think is shocking, really, considering it's really important, and
surely ya'll know a heck of a lot more about it than me.

Of course, having it be good documentation is important, but there's nothing
there, it's just a huge big gaping hole.

I'm sorry if I'm a little impatient, but this is not a difficult thing!
It's a completely doable thing!  Ne?  So, let's just get it all down, and
then figure out what's the best way to present the information given.

Anisa.

-- 
*********************************
www.AnimeCards.Org

16,000 scans and counting!
*********************************
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20061009/65298efb/attachment.htm