[Bioperl-l] http://www.bioperl.org/wiki/Bptutorial.pl

[Brian Osborne]

Chris,

I think the INSTALL* files should be in the package, this is the de facto
convention for 99% of the packages I've ever seen. Then any Wiki page just
links to the file in CVS.

Personally I don't like the idea of maintaining a Wiki page and a file that
both say essentially the same thing (this is what has happened with the
INSTALL and INSTALL.WIN files). I've spent plenty of time merging redundant
text and removing files that contained these redundancies so it's
unfortunate to see them appear anew, sooner or later they'll get out of sync
despite best intentions. The most likely cause will be someone other than
the person who created the initial duplication (and promised to maintain
both) making a change in one of the two files.

Brian O.


On 6/1/06 12:20 PM, "Chris Fields" <cjfields at uiuc.edu> wrote:

> Also, what do we do about similar situation with other docs moved to the
> wiki (INSTALL, INSTALL.WIN, etc)?  Should we have a placeholder file in the
> distribution pointing out the wiki docs instead?