About the abstract and rationale
Amirouche Boubekki 21 Feb 2021 09:39 UTC
The abstract is the following:
> This is a set of convenience routines for generators and accumulators intended to blend in with SRFI 158. The authors recommend that they be added to the (srfi 158) library provided by users or implementations. If they are approved by the R7RS-large process, they can also be added to (r7rs generator).
I think only the first paragraph is useful in the abstract. The rest
might go into another section of the document, I am not sure which
one.
Maybe the first sentence of the rationale can go inside the abstract:
> make it easier to set up and make use of pipelines of generators.
The rationale should be more general about the big or common idea (if
any) of the current SRFI. At the moment, it is explaining why each
form makes sense and _how to_ use those forms. That is great, but the
wrong section. As an implementer or a user, I like to have the
information about a form, in the specification documentation of that
form.