[Bioperl-l] Re: bioperl FAQ

peter.masiar@yale.edu peter.masiar@yale.edu
Wed, 29 May 2002 11:43:22 -0400 (EDT)


Quoting bioperl-l-request@bioperl.org:

> From: Heikki Lehvaslaiho <heikki@ebi.ac.uk>
> 
> I started playing with the Bioperl FAQ yesterday. I am putting it into
> XML
> using XML::Twig FAQ structure as a base.
> 
> I am expanding the XML structure to allow sections of questions as in
> the
> current FAQ. I have the faq2html.pl almost ready. I'll move the rest of
> the
> FAQ into the XML and write faq2text.pl soon.
> 
> I planning to put all the files into a new faq directory. The current
> FAQ
> can be deleted or generated from faq/faq.xml.
> 
> Just to let you know to avoid redundant work getting done.
> 
> 	-Heikki

> From: Jason Stajich <jason@cgt.mc.duke.edu>
> Subject: Re: [Bioperl-l] bioperl FAQ
> 
> great stuff - thanks for getting it going, I wasn't sure what was an
> accepted XML FAQ format.  Any chance you write a faq2txt? I'll make
> sure
> it gets run and produces the file before a release.   I guess now might
> be
> a good time to start a new doc/ directory?
> 
> -jason
> 
> On Wed, 29 May 2002, Heikki Lehvaslaiho wrote:
> 
> -- 
> Jason Stajich
> Duke University
> jason at cgt.mc.duke.edu
> 

I am using wiki for our documentation needs - TWiki clone.
Much more flexible than old HTML. 
TWiki is clone of wiki focused for business.
Has user authorisation, full version control (RCS)
and flexible expandable architecture.
Registered users can update pages using plain browser,
(no need to use HTML editor and upload page)
and can get email with link to pages changed recently.
And many other goodies...

Wiki eliminates one-webmaster-syndrome.
Any (registered) user can change pages, or fix mistakes of other.
After a while, information on page refines, and you do not have
to search throught noise like in email archives.
Also, in wiki is really easy to link to other pages.

TWiki is written in perl, open-source, see http://twiki.org

If interested, I can even host bioperl FAQ wiki on our server, I guess.
We have server, but I did not asked permission yet :-)

Another option (less flexible, but better performance) is FAQ-O-Matic.

Just my $.02

Peter Masiar, peter.masiar@yale.edu, (203) 764-8131