Mailing-List: contact dev-help@forrest.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@forrest.apache.org
Received-SPF: neutral (hermes.apache.org: local policy)
Date: Wed, 8 Jun 2005 12:53:40 +1000
From: David Crossley <crossley@apache.org>
To: dev@forrest.apache.org, Tim Williams <williamstw@gmail.com>
Subject: Re: cocoon protocols
Message-ID: <20050608025340.GA23560@igg.indexgeo.com.au>
References: <4998884405060521224ca31b0d@mail.gmail.com>
 <42A4241C.8080808@apache.org> <4998884405060617345301dfd@mail.gmail.com>
 <42A5696F.6040703@apache.org> <499888440506071425546f5c18@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <499888440506071425546f5c18@mail.gmail.com>
User-Agent: Mutt/1.4i

Tim Williams wrote:
> ...
> > > I may very well be getting confused on the terms root and current.
> > > The forrest docs say that " Forrest's sitemap comprises the
> > > $FORREST_HOME/context/*.xmap files."  This leads me to believe that
> > > the terms root and current are conceptual rather than physical which
> > > would mean they are one and the same for the forrest cocoon app and
> > > mounting is just a mechanism to bring the physical maps together?
> > 
> > Firstly that documentation is now misleading because we have plugin
> > sitemaps and project sitemaps as well now. Can you please point us to
> > the file you read that in so we can clarify it.
> 
> Sure, it's http://forrest.apache.org/0.7/docs/sitemap-ref.html  I've
> got a patch for it that adds  {project.sitemap-dir} and the plugins. 
> And while we're on the fixing documentation subject, what's the
> preferred method for receiving them?  Seems kinda heavyweight to open
> an issue for a relatively minor doc change but then I understand
> patches through email is frowned upon.

Jira please. The few active committers are so busy these days that
it is very easy to miss things. Jira doesn't solve that but it does help.

> ...
> > It may help you top read
> > http://forrest.apache.org/0.7/docs/howto/howto-custom-html-source.html
> > Although this how-to is not about what you want to do it does have a
> > very clear description of the logic in sitemap processing.
> 
> It is most unfortunate that such a good discussion of the pipeline
> process is hidden under that title.  It even says the intended
> audience is "everybody who wants to learn more about Forrest's
> pipelines in general."   I *highly* recommend changing this title to
> something more generic and even consider putting in the main docs. 
> Something like "Forrest Pipelines by Example" should get folks
> attention.  This short little doc could have literally shaved days off
> my learning curve.

We should add a note the the FAQs to direct people to it.

--David