SRFI-metadata-syncing SRFI? noosphere@xxxxxx (08 Nov 2020 21:50 UTC)
Re: SRFI-metadata-syncing SRFI? Vladimir Nikishkin (09 Nov 2020 01:00 UTC)
Re: SRFI-metadata-syncing SRFI? Lassi Kortela (09 Nov 2020 09:41 UTC)
Re: SRFI-metadata-syncing SRFI? noosphere@xxxxxx (09 Nov 2020 16:15 UTC)
Re: SRFI-metadata-syncing SRFI? Lassi Kortela (09 Nov 2020 16:36 UTC)
(missing)
Re: SRFI-metadata-syncing SRFI? noosphere@xxxxxx (09 Nov 2020 20:35 UTC)
Re: SRFI-metadata-syncing SRFI? Lassi Kortela (09 Nov 2020 20:57 UTC)
Re: SRFI-metadata-syncing SRFI? Lassi Kortela (09 Nov 2020 21:05 UTC)
Re: SRFI-metadata-syncing SRFI? noosphere@xxxxxx (09 Nov 2020 23:41 UTC)
Re: SRFI-metadata-syncing SRFI? Lassi Kortela (10 Nov 2020 07:53 UTC)
Re: SRFI-metadata-syncing SRFI? noosphere@xxxxxx (09 Nov 2020 23:45 UTC)
Re: SRFI-metadata-syncing SRFI? noosphere@xxxxxx (09 Nov 2020 20:50 UTC)
Re: SRFI-metadata-syncing SRFI? Lassi Kortela (09 Nov 2020 21:12 UTC)
The funnel pattern Lassi Kortela (09 Nov 2020 21:30 UTC)

The funnel pattern Lassi Kortela 09 Nov 2020 21:30 UTC

In general, in all Schemedoc endeavors I've been involved with, I've
tried to use the "funnel" pattern.

Ideally there's a "single point of truth" which is located as close as
possible to the authoritative source of that information. For example,
since a Scheme implementation is the authoritative source on its SRFI
support, having the point of truth in the implementation is most direct.

That source information is then fed through a filter, whose output may
be fed through another filter, etc. to produce whatever useful outputs
people want. The source information is quite delicate because it must be
written by hand. The filters are not similarly delicate because they are
code that is self-documenting, can be fixed, and ideally doesn't need to
change much over time.

A key constraint of the funnel pattern is that information flows one way
only. There are no loops; this means you can build a directed graph of
the information flowing downstream. Ideally we could aggregate
everything into one place at api.scheme.org using this pattern.