[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: First impressions of the specification

This page is part of the web mail archives of SRFI 110 from before July 7th, 2015. The new archives for SRFI 110 contain all messages, not just those from before July 7th, 2015.

Mark H Weaver:
> I think that most readers will find the BNF quite intimidating, so it
> would be good if casual readers could obtain a reasonably clear
> understanding of the rules without reading the BNF.  This new text is a
> great start, but IMO it needs to include an english description of the
> action rules as well.

I don't think an "English description of the action rules" would help,
but I understand the basic concern.

Perhaps we could add a short "tutorial" section before the
"specification" section to give people a brief overview.
Then, when people read the actual spec, they'll have an idea
of what the spec is trying to accomplish.
There's no "tutorial" section in the official outline, but as long
as we include the minimum set of headings I don't see why that'd
be a problem.

--- David A. Wheeler