You are viewing a plain text version of this content. The canonical link for it is here.
Posted to torque-dev@db.apache.org by Thomas Fischer <tf...@apache.org> on 2007/03/20 19:55:50 UTC
keeping old doc versions
Hi,
While deleting old releases from the distribution directory, the question
raised what should be done with the old docs. Thomas V has already
expressed that in his opinion, the old site versions should be removed. In
my opinion, however, they should be preserved for the following reason:
>From the uers list, there are still some people using the old versions. As
the docs cannot be downloaded from archive.apache.org(docs are not
included in the source), the only access to old docs is to check out the
svn source and building the docs themselves, which I'd consider a
nuisance.
The downside of keeping the old docs is that the information given there
may be obsolete or incorrect, e.g. about cvs access (I have manually
changed the download info, but doing this for every infra change in all
the archived sites is not feasible in my opinion). However, I'd guess
that people understand that this kind of information may no longer be
valid in an archived site.
Any other opinions ?
Thomas
---------------------------------------------------------------------
To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org
For additional commands, e-mail: torque-dev-help@db.apache.org
RE: keeping old doc versions
Posted by Greg Monroe <Gr...@DukeCE.com>.
Sounds like a good plan, that probably works out
about the same as mine.
FWIW, wget is a GNU "non-interactive network
retriever" that's been around for years. (I used
the Cygwin version).
This is designed to "grab" info from the Internet
and create a local copy. The one thing that it
adds to the mix is how it handles some required
files. E.g., it will grab required images/style
sheets from the same site but outside the specified
URL and move it into the directory and rewrite the
URL's in the retreived HTML pages.
Makes a nice quick way to get a "snapshot" of
a section of an online site.
> -----Original Message-----
> From: Thomas Fischer [mailto:tfischer@apache.org]
> Sent: Saturday, March 24, 2007 12:40 PM
> To: Apache Torque Developers List
> Subject: RE: keeping old doc versions
>
> I do not understand about the wget stuff, but we could simply
> take the live versions of the docs from the directory where
> they are currently served from and create a .zip and a
> .tar.gz from them. Then we could create a directory on
> archive.apache.org, e.g.
> http://archive.apache.org/dist/db/torque/docs
> and put the zipped and tar.gz'ed versions there. The policy
> says we must sign them, so a .md5 and a .asc will go along.
> Then we could put a link to this into
> http://db.apache.org/torque/documentation/previous-releases.html
> We'd keep only an arcive of the docs of the current
> production release.
>
> If nobody objects, I could prepare this by removing the links
> to older versions of the docs in the current site. After the
> site is published again in RC3, we can then to the zipping,
> signing and removing.
>
> Thomas
>
> On Tue, 20 Mar 2007, Greg Monroe wrote:
>
> > Having the old site/docs available would be nice. But I don't think
> > they should be online since it leads to Google searches finding
> > old/invalid info that people don't realize it's from and archived
> > site.
> >
> > How about doing the following on each old version to create a
> > torque-site-X.x.x.zip that could be downloaded from the
> archive site.
> >
> > wget -r -k -np
> > http://db.apache.org/torque/releases/torque-3.1/index.html
> >
> > Then copy the maven*.css files to the styles directory
> created under
> > the db.apache.org/torque/releases/torque-3.1 directory.
> >
> > I just did this for 3.1 and it looks usable from from my hard drive.
> >
> > For future versions we could generate a site source zip
> from the site
> > project's target docs directory.
> >
> > Greg
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org
> For additional commands, e-mail: torque-dev-help@db.apache.org
>
>
Duke CE Privacy Statement
Please be advised that this e-mail and any files transmitted with it are confidential communication or may otherwise be privileged or confidential and are intended solely for the individual or entity to whom they are addressed. If you are not the intended recipient you may not rely on the contents of this email or any attachments, and we ask that you please not read, copy or retransmit this communication, but reply to the sender and destroy the email, its contents, and all copies thereof immediately. Any unauthorized dissemination, distribution or copying of this communication is strictly prohibited.
---------------------------------------------------------------------
To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org
For additional commands, e-mail: torque-dev-help@db.apache.org
RE: keeping old doc versions
Posted by Thomas Fischer <tf...@apache.org>.
I do not understand about the wget stuff, but we could simply take the
live versions of the docs from the directory where they are currently
served from and create a .zip and a .tar.gz from them. Then we could
create a directory on archive.apache.org, e.g.
http://archive.apache.org/dist/db/torque/docs
and put the zipped and tar.gz'ed versions there. The policy says we must
sign them, so a .md5 and a .asc will go along.
Then we could put a link to this into
http://db.apache.org/torque/documentation/previous-releases.html
We'd keep only an arcive of the docs of the current production release.
If nobody objects, I could prepare this by removing the links to older
versions of the docs in the current site. After the site is published
again in RC3, we can then to the zipping, signing and removing.
Thomas
On Tue, 20 Mar 2007, Greg Monroe wrote:
> Having the old site/docs available would be nice. But
> I don't think they should be online since it leads to
> Google searches finding old/invalid info that people don't
> realize it's from and archived site.
>
> How about doing the following on each old version to create
> a torque-site-X.x.x.zip that could be downloaded from the
> archive site.
>
> wget -r -k -np
> http://db.apache.org/torque/releases/torque-3.1/index.html
>
> Then copy the maven*.css files to the styles directory created
> under the db.apache.org/torque/releases/torque-3.1 directory.
>
> I just did this for 3.1 and it looks usable from from my
> hard drive.
>
> For future versions we could generate a site source zip from
> the site project's target docs directory.
>
> Greg
>
---------------------------------------------------------------------
To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org
For additional commands, e-mail: torque-dev-help@db.apache.org
RE: keeping old doc versions
Posted by Greg Monroe <Gr...@DukeCE.com>.
Having the old site/docs available would be nice. But
I don't think they should be online since it leads to
Google searches finding old/invalid info that people don't
realize it's from and archived site.
How about doing the following on each old version to create
a torque-site-X.x.x.zip that could be downloaded from the
archive site.
wget -r -k -np
http://db.apache.org/torque/releases/torque-3.1/index.html
Then copy the maven*.css files to the styles directory created
under the db.apache.org/torque/releases/torque-3.1 directory.
I just did this for 3.1 and it looks usable from from my
hard drive.
For future versions we could generate a site source zip from
the site project's target docs directory.
Greg
> -----Original Message-----
> From: Thomas Fischer [mailto:tfischer@apache.org]
> Sent: Tuesday, March 20, 2007 2:56 PM
> To: torque-dev@db.apache.org
> Subject: keeping old doc versions
>
> Hi,
>
> While deleting old releases from the distribution directory,
> the question raised what should be done with the old docs.
> Thomas V has already expressed that in his opinion, the old
> site versions should be removed. In my opinion, however, they
> should be preserved for the following reason:
> From the uers list, there are still some people using the old
> versions. As the docs cannot be downloaded from
> archive.apache.org(docs are not included in the source), the
> only access to old docs is to check out the svn source and
> building the docs themselves, which I'd consider a nuisance.
> The downside of keeping the old docs is that the information
> given there may be obsolete or incorrect, e.g. about cvs
> access (I have manually changed the download info, but doing
> this for every infra change in all the archived sites is not
> feasible in my opinion). However, I'd guess that people
> understand that this kind of information may no longer be
> valid in an archived site.
>
> Any other opinions ?
>
> Thomas
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org
> For additional commands, e-mail: torque-dev-help@db.apache.org
>
>
Duke CE Privacy Statement
Please be advised that this e-mail and any files transmitted with it are confidential communication or may otherwise be privileged or confidential and are intended solely for the individual or entity to whom they are addressed. If you are not the intended recipient you may not rely on the contents of this email or any attachments, and we ask that you please not read, copy or retransmit this communication, but reply to the sender and destroy the email, its contents, and all copies thereof immediately. Any unauthorized dissemination, distribution or copying of this communication is strictly prohibited.
---------------------------------------------------------------------
To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org
For additional commands, e-mail: torque-dev-help@db.apache.org