[Sca-cooks] documentation

Stefan li Rous StefanliRous at austin.rr.com
Wed Oct 4 00:37:09 PDT 2006


Elizabeta commented:
<<< In my opinion, documentation is
desirable, as it allows others to see and hopefully recreate what you're
doing, possibly using or jumping off from the sources you've used. >>>

One of the prime reasons that the Florilegium was started, was so  
that people could make use of the knowledge of others without having  
to start over from the beginning. Along those lines, I would love to  
have more A&S documentation for the Florilegium, if it will stand  
alone without the actual item(s). This especially applies to papers  
entered into A&S contests, since in that case, they have no item  
whose being missing would risk losing some of the information being  
presented.

<<< In some
situations, such as major A&S competitions, I would say that  
documentation
is even necessary and probably should be required.  Now having said  
that,
for small local competitions where you have people entering  
competitions for
the first time, documentation can be a major stumbling block,  
especially if
they're new enough that they've never run across documentation. >>>

My own, few A&S entries have suffered from this. That and trying to  
start on the documentation just before the event. :-)

To help those folks that are not scared of coming up with  
documentation, I've tried to have a selection of articles on this  
subject in the Florilegium. Unfortunately, the appropriate  
documentation and it's amount, often seem to differ by contest and  
perhaps by individual judge.  If you have folks who are uncertain of  
writing up their documentation for their A&S project, you might want  
to point them to these files in the CELEBRATIONS AND EVENTS section  
of the Florilegium:
5x8-Doc-art       (19K)  2/17/99    "5x8 Documentation Is All It  
Takes: How to
                                        Write Documentation for A&S  
Entries" by
                                        Gunnora Hallakarva.
AS-cont-docu-msg  (44K)  1/25/01    Documentation suggestions for A&S  
contests.
Documentation-art (12K)  8/22/04    "Documentation - a Quick and  
Painless Guide"
                                        by Ld. Daniel Raoul le Vascon.
Narfing-Iron-art  (12K) 10/23/00    "A Brief Beginner's Guide to  
Documentation"
                                        by Lady Jehanne de Huguenin.

Stefan
--------
THLord Stefan li Rous    Barony of Bryn Gwlad    Kingdom of Ansteorra
    Mark S. Harris           Austin, Texas           
StefanliRous at austin.rr.com
**** See Stefan's Florilegium files at:  http://www.florilegium.org ****




More information about the Sca-cooks mailing list