On Thu, Mar 7, 2019 at 1:07 AM Alex Shinn <xxxxxx@gmail.com> wrote: >> Besides Arthur's point, the other issue with Scribble is that it is >> very Scheme centric and "exotic". Many smaller Scheme implementations >> wouldn't be able to come up with a Scribble implementation right away. > > > I would argue that Scheme - centric is a good thing for SRFIs, and there's a portable R7RS implementation in Chibi. I think that our perspectives differ a lot on this one mainly based on how we view Scheme: * you as the developer of Chibi -- a major R7RS implementation (and with a lot of extras) -- see Scheme as a "major" programming language; * me on the other side see Scheme as a DSL language that could be used instead of Lua in may places; Therefore if one would to implement a scheme interpreter (like I was), and if one would like to integrate the SRFI (and especially R7RS) documentation in his own implementation, one would have a hard time, especially since in order to extract the documentation one would have to use an external implementation. This is why I'm insisting on a more language "neutral" format that can be easily translated to other desired formats. > Though I may just use Scribble to output the HTML with classes. HTML is too much work for me too write by hand already - there's no way I'm manually adding classes. As Arthur also highlighted, given that the SRFI text doesn't change once it was approved, you can still use Scribble and export it to HTML. Ciprian.