> On Wed, Mar 13, 2019 at 7:46 PM Lassi Kortela <xxxxxx@lassi.io> wrote:
>> Just realized: Do you mean that you'd eventually want to publish a
>> standard syntax for static type signatures as part of the SRFI
>> submission guidelines, so that authors of new SRFIs could directly write
>> their own types in that syntax if they want to?
>
> The short answer: no. I don't think it is feasible; nor will Arthur
> accept it, neither will the other editors want to go with it.
OK, sorry for any possible mischaracterization :)
> The volunteers can know that the syntax is right by running an
> automated tool that validates and extracts data from the document and
> additional files. And if it changes we do as you did with the ISO
> dates: someone proposes the change, tries it out, changes the tools,
> and submits a pull request for the existing dataset. (But as the
> format will be more geared towards automatic processing, this last
> part should be easier to achieve than it is today.)
Sure :) This is fine if the types are separate from the SRFI HTML. Then
we can freely improve and change them and run a tool to check.
> All my previous statements take into account the workflow I've
> proposed a few emails ago:
> * the author writes the SRFI as he wants (and is accepted by the editor);
> * the editor together with the author finalize the document in the
> "free-form" HTML format;
> * from here on the "volunteers" (or if time permits the editor and/or
> author) would take the HTML, reformat it and augment it as needed, and
> add the signatures;
> * (nothing prevents the author to start with this last form, but it is
> not part of the SRFI requirements / guidelines;)
This process is great.
I've been thinking it would be great to have a web dashboard showing the
conversion status of all SRFIs at a glance. I made a demo of how it
might look (the checkmarks are randomized):
http://lassi.io/temp/srfi-status-dashboard.html
This kind of visual overview would be a big motivator for me: just keep
working at it until all the rows are green.
The dashboard would be auto-updated by our verification tool running on
some Continuous Integration server :) We could install Git hooks onto
the SRFI GitHub repos to submit all pull requests for checking to CI. I
believe GitHub can even be configured so that merging to the master
branch is not allowed until the checks pass.