[documentation] multi site docs

[Gary Feldman]

Anisa wrote:
> Boo!  :)  I still think it's visually difficult.   It feels... wrong 
> somehow. Certainly, the sites are all managed in one directory tree, 
> but then why bother with tree, why not just say Drupal directory?  Or 
> Drupal installation?  When I said I'd never heard of it, I meant in 
> the context of multi sites on Drupal.  Why do you need tree, what does 
> it make better, and why aren't you writing multi site documentation 
> while you're at it?  ;)
Calling it the "Drupal installation directory" is a viable alternative 
to tree.  Tree is what I'm used to, and it makes it clear that the 
subdirectories are included, but then my background is in development.  
Also, once the term "installation tree" is introduced, it can be 
shortened to "tree," which is distinctive, but shortening "installation 
directory" to "directory" is likely to be more confusing. 

As for your last question, part of the answer is that I'm much better at 
editing than writing, and part of the answer is that I picked a bad time 
to quit, so my boss convinced me to stick around for another month or so :-)

Gary
>
> Sorry to be picky!  I'm just trying to understand.  :)
>
> Anisa.
>
> On 10/12/06, *Gary Feldman* <dpal_gaf_doc at marsdome.com 
> <mailto:dpal_gaf_doc at marsdome.com>> wrote:
>
>     Anisa wrote:
>     > Hmmm...
>     >
>     > Is there anything better?
>     >
>     > If codebase is a problem, in that say, it's technically wrong, then
>     > perhaps 'where drupal is installed' is just as good.
>     >
>     > I've never heard installation tree, and it's not really tree
>     like in
>     > structure, since it suggests that the baby sites branch off the main
>     > site, whereas in reality, they often have nothing to do with
>     each other.
>     It's a directory tree, not a site tree.  Think of it as it might
>     appear
>     in the folder pane of the Windows Explorer:
>         drupal/
>             includes/
>             modules/
>             themes/
>
>     The directories form a tree, with Drupal at the root.  It's fairly
>     common to describe a root directory with a set of subdirectories as a
>     directory tree.
>
>     Gary
>
>     >
>     > An image problem?
>     >
>     > Anisa.
>     > starting to understand the code is gold proverb...
>     >
>     > On 10/12/06, *Gary Feldman* < dpal_gaf_doc at marsdome.com
>     <mailto:dpal_gaf_doc at marsdome.com>
>     > <mailto:dpal_gaf_doc at marsdome.com
>     <mailto:dpal_gaf_doc at marsdome.com>>> wrote:
>     >
>     >     Anisa wrote:
>     >     > Now that I have my own multisite (yay!), I started working
>     on those
>     >     > multi site docs again.  My rough drafts are here:
>     >     Getting back to the "codebase" question, my preference is
>     >     "installation
>     >     tree."  It's a concrete reference to the directory tree where
>     >     Drupal is
>     >     installed.
>     >
>     >     The term "code base" connotes, in my mind, the original
>     source code at
>     >     the Drupal.org <http://Drupal.org> < http://Drupal.org>
>     site.  It's a more abstract
>     >     term, so that one might say
>     >     "CivicSpace is built on the Drupal code base."  See the
>     Wikipedia
>     >     entry
>     >     ( http://en.wikipedia.org/wiki/Codebase) for another example
>     (and no, I
>     >     didn't submit the Wikipedia entry).
>     >
>     >     Gary
>     >
>     >     --
>     >     Pending work: http://drupal.org/project/issues/documentation/
>     >     List archives: http://lists.drupal.org/pipermail/documentation/
>     >
>     >
>     >
>     >
>     > --
>     > *********************************
>     > www.AnimeCards.Org <http://www.AnimeCards.Org>
>     <http://www.AnimeCards.Org>
>     >
>     > 16,000 scans and counting!
>     > *********************************
>     >
>     ------------------------------------------------------------------------
>     >
>     > --
>     > Pending work: http://drupal.org/project/issues/documentation/
>     > List archives: http://lists.drupal.org/pipermail/documentation/
>
>
>     --
>     Pending work: http://drupal.org/project/issues/documentation/
>     List archives: http://lists.drupal.org/pipermail/documentation/
>
>
>
>
> -- 
> *********************************
> www.AnimeCards.Org <http://www.AnimeCards.Org>
>
> 16,000 scans and counting!
> *********************************
> ------------------------------------------------------------------------
>
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/