Remove doc?

[James Blackwell]

On Sat, Feb 25, 2006 at 06:06:01AM +1100, Martin Pool wrote:
> On 23 Feb 2006, John Arbash Meinel <john at arbash-meinel.com> wrote:
> > Aaron Bentley wrote:
> > > The files in bzr's doc directory are almost entirely not documentation
> > > about bzr.  They're design docs and explorations of other VCSes.  These
> > > docs have served their purpose and are now unmaintained.  I propose we
> > > yank them.
> > > 
> > > Aaron
> > 
> > I think it would be okay to move them to another directory. Certainly it
> > seems like 'bzr/doc' would be documentation about bzr. Maybe,
> > bzr/doc/other_scms
> > 
> > I don't know if we should just delete them. It is kind of a good
> > summary. Though I guess if they aren't being maintained at all, then it
> > would be better to just get rid of them.
> 
> Some of them are about bzr but they are quite out of date, and probably
> just misleading to most people who would read them.  We should perhaps
> keep them somewhere for historical interest, and the ones which still
> have value could be moved to the wiki.
> 
> They used to be on the web site under /obsolete-docs but in the recent
> reorganization that seems to be broken (?).

I guess you could call it broken though I did it intentionally. I figured
that they had been sitting there obsoleted and ignored for awhile. 

Perhaps it makes sense to set a standard for what among these two piles of
obsolete things is worth saving? One potential standard would be for there
to be an ObsoleteDocs page. Anyone that decides that a document is worth
retention could express it by wikifying it and putting up a link on the
the page.

Comments?

-- 
My home page:   <a href="http://jblack.linuxguru.net">James Blackwell</a>
Gnupg 06357400  F-print AAE4 8C76 58DA 5902 761D  247A 8A55 DA73 0635 7400
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 191 bytes
Desc: Digital signature
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20060224/c82ba51a/attachment.pgp