[futurebasic] Re: [FB] Wiki Book for FutureBASIC

Message: < previous - next > : Reply : Subscribe : Cleanse
Home   : January 2008 : Group Archive : Group : All Groups

From: Robert Purves <listrp@...>
Date: Mon, 28 Jan 2008 21:34:11 +1300
Christopher Wyatt wrote:

> As we seem to need an up-to-date reference manual, why not use a  
> Wiki Books entry to create a common manual online? The nice thing  
> about such a book is that we can use the results to create more  
> traditional documents over time. Plus, the experts on this mailing  
> list and from around the net could help correct errors in documents.
>
> Anyone else have an opinion? I could get things started, at least,  
> and then post the appropriate links.
>
> I certainly couldn't write all the documents, but I bet I could make  
> it an alternative assignment for my technical writing / design   
> students. That could really speed things up -- and offer them very  
> real-world experience with tech documents.

We certainly need an up-to-date reference manual. It should document  
the language as understood by FBtoC.

The current Reference Manual (for example the HTML version, "FB  
Reference" in the Help menu) does a reasonable job of documenting the  
language as understood by the obsolete FB Compiler. The FBtoC team, in  
the person of Bernie, has successfully created an Apple HelpBook with  
the same content as FB Reference. An documentation enthusiast with  
lots of spare time, a powerful HTML editor, and sufficient knowledge  
of FB and FBtoC, could in principle bring the HelpBook up-to-date, by  
editing content and format. Unfortunately, we know of no such  
enthusiast.

A cooperative effort via a wiki seems a much better idea.

Robert P.