[Bioperl-l] Re: bioperl FAQ

[chris dagdigian]

Hi Peter etc.

As much as I like Wiki it seems that having most of our documentation 
(and FAQ) information be included  as static text files in our 
distribution is the better way to go given our past history.

We have a far better track record of our developers working on the 
CVS-resident codebase than doing anything with the website. We will 
probably get much more effort and attention put into the docs and the 
FAQs if our developers were able to add/edit/etc files and 'cvs commit' 
them back into the project repository. If we require people to do 
something on the web then the number of people who contribute will drop 
sharply.

Some sort of XML-based FAQ that can easily be transformed into 
HTML/text/PDF/etc. etc. seems like the appoach that will work best for 
bioperl people.

On a side note I'm working on the next generation website stuff and if 
we go ahead with plans to build on top of Zope and CMF then we can 
easily Wiki-enable the websites as there are several good quality wiki 
implementations that have been done under the Zope/CMF portal framework.

-Chris



peter.masiar@yale.edu wrote:

>Quoting bioperl-l-request@bioperl.org:
>
>  
>
>>From: Heikki Lehvaslaiho <heikki@ebi.ac.uk>
>>
>>This for Peter Masiar for suggesting the Twiki. There are quite a lot of
>>us
>>who hae used wiki and I think it would be grat if we had more people
>>writing
>>docs and web pages. 
>>
>>As fas as I can see neither twiki or FAQ-O-Matic can generate a plain
>>text
>>version to be included into distribution.
>>
>>	-heikki
>>    
>>
>
>TWiki is little different from other wikis I researched.
>Because generating HTML is used rather often, it has feature to do that:
>
>Following page describes how TWiki can generate static HTML pages 
>from all pages in wiki folder:
>http://twiki.org/cgi-bin/view/Plugins/GenHTMLAddon
>
>GenHTML script was developed by Crawford Currie for Motorola.
>I'll find out if it works and let you know in couple of days.
>Sorry, way to busy right now. :-(
>
>If generating static HTML from TWiki pages works, are you interested?
>Or you still prefer manual edit?
>
>Peter Masiar, peter.masiar@yale.edu
>_______________________________________________
>Bioperl-l mailing list
>Bioperl-l@bioperl.org
>http://bioperl.org/mailman/listinfo/bioperl-l
>  
>


-- 
Chris Dagdigian, <dag@sonsorol.org>
Life Science IT & Research Computing Freelancer
Office: 617-666-6454, Mobile: 617-877-5498, Fax: 425-699-0193
PGP KeyID: 83D4310E  Yahoo IM: craffi