On Wed, May 8, 2019 at 10:10 AM Lassi Kortela <xxxxxx@lassi.io> wrote:

The HTML-as-S-expressions format actually sounds very reasonable. Maybe
we should first investigate what has the best tooling (or is easiest to
write new tools for). Would something Scribble-like work? That would be
close to HTML-as-Sexprs. Even Texinfo could be a contender - tons of
other Scheme documentation is using it so we'll have to write some tools
to index and render it at some point anyway.

I only mention that in passing, but didn't mean to recommend it. The problem with formats based on S-expressions is that there are so many to choose among. I'd stick with Markdown or Org mode, both of which are supported by tons of tools and are widely understood and used.

But if we don't get permission we'd probably have to start a new
cookbook from scratch at some point in order to give up-to-date advice
and cover more implementations. It'd be a shame if users had to keep
switching between two different cookbooks for the same job.

I don't think we need permission as much as information about their plans. After all, they did use a permissive license. I just want to be polite and to make sure we're not stepping on their toes.