Re: HTML Custom Elements to help in SRFI writing?
Artyom Bologov 18 Aug 2026 04:16 UTC
Hello Maxim,
>> For those who want a machine-processable SRFI information, there is
>> https://github.com/schemeorg-community/scheme-index (that powers
>> index.scheme.org and scheme-index.aartaka.me.) It is incomplete, but
>> quite expansive already. Help improving it, and we’ll all have a good
>> machine-readable SRFI reference!
>
> That sounds useful; is it maintained by hand, or does it extract the
> useful information from the SRFI sources (HTML) ?
It is maintained by hand right now. Which I consider a virtue, as
parsing SRFI documents would be extremely unreliable and essentially
require re-inventing parsing per each individual SRFI / author.
> It's also only for the procedures/macros, etc., not the explanatory text
> of SRFI itself, which I've used to documented e.g. SRFI 64 in Guile
> (converted from HTML via the snarfi hack/script linked earlier).
Indeed, the descriptions in scheme-index are focused on individual
APIs. Yet this is probably the thing most people wanting
machine-processable SRFIs want. But I realize the incompleteness!
Thanks,
--
Artyom Bologov
https://aartaka.me