Re: [boost] Re: FSM library question

From: Rob Stewart (stewart_at_[hidden])
Date: 2005-02-28 17:35:25

From: Andreas Huber <ahd6974-spamgroupstrap_at_[hidden]>
> 
> > > The tutorial is primarily addressed to people who already have had 
> > > exposure to FSMs (and also had to implement them one way or another). 
> > > You are right, a beginner with only theoretical or even no prior 
> > > knowledge about FSMs would probably shake his head before even following 
> > > through the StopWatch example. I've spent quite some time thinking how I 
> > > could also address newbies but have come to the conclusion that this 
> > > would require a separate document at least as large as the tutorial.
> > 
> > A tutorial is typically assumed to be addressed at newbies.  If
> > you are aiming at a different, more advanced audience, just say
> > so.  That should eliminate the confusion.
> 
> I think I am saying so: http://tinyurl.com/3kkog (Audience)

I don't think that quite does it.  The difference is that there
you say that you assume familiarity with the subject matter and
terminology, but nothing about experience.  It is the latter that
would permit the reader to recognize the StopWatch example as a
toy and to map the code in the example to FSMs previously
implemented other ways.

> > To avoid misconceptions, a disclaimer stating that the StopWatch
> > example is too simple to benefit much from Boost.FSM, but serves
> > to show how to use the library, would probably be a good idea.
> 
> It seems that you haven't read the whole post. I've already agreed with Jeff 
> that I will write something in this direction.

Actually, I did read it, but I was trying to suggest the flavor
of what you might add to the document.

-- 
Rob Stewart                           stewart_at_[hidden]
Software Engineer                     http://www.sig.com
Susquehanna International Group, LLP  using std::disclaimer;