forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Gav..." <ga...@16degrees.com.au>
Subject RE: stop re-generating PDF documents on Forrest website
Date Sun, 06 Jun 2010 09:40:24 GMT


> -----Original Message-----
> From: David Crossley [mailto:crossley@apache.org]
> Sent: Sunday, 6 June 2010 4:42 PM
> To: dev@forrest.apache.org
> Subject: stop re-generating PDF documents on Forrest website
> 
> We have a PDF document copy of every page of our website.
> 
> I propose that we stop doing that. There are various reasons.
> 
> It makes it difficult to search, because one keeps hitting
> the PDF documents as well as the html pages.
> 
> Due to issue https://issues.apache.org/jira/browse/FOR-1077
> every PDF document is changed each time someone re-generates
> some other part of the website. This creates a lot of noise
> with the commit diffs making it difficult to oversee real changes.
> 
> We aleady demonstrate this ability with the PDF Plugin's own
> website and also with our example site on our zone server.
> Also the "sample" document on the main website has a
> demo http://forrest.apache.org/dtdx/document-v20.html#presentations
> 
> So i plan to go ahead and remove that soon, unless people
> speak up with concerns.

++1 to that, like you say, we don't actually need them for our docs, the
same way we don't need POD or Text or other plugins, as long as they are
documented and we have running examples elsewhere, it's all good.

Gav...

> 
> -David



Mime
View raw message