[documentation] multi site docs

[Anisa]

On 10/13/06, Gary Feldman <dpal_gaf_doc at marsdome.com> wrote:
>
> 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.


Ah ha!  Your shady past comes to light.  ;)

Subdirectories don't have a lot to do with anything in this case.

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.


I agree with this directory thing.  Too many people have folder issues,
drupal is installed in sub directories, sub domains, subdomains that are
folders, etc.  So, like I said, we can go for the clause, 'where drupal is
installed', and avoid the whooooole thing all together.  Alternatively,
drupal root, if you must.

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
> :-)


Uh huh.  ;)  Please do let me know if you have more feedback on the docs.

Anisa.

> >
> > 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/
>
>
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>



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

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