Documentation workflow based on Kindly & Clay

[daslu]

edit: corrected parhs

New experimental dev workflow

This PR is part of our work on a new dev workflow for Tablecloth:

• namespace-as-a-notebook documentation using Kindly and Clay -- this PR
• testing the documentation using note-to-test -- coming soon

Status

Not to be merged yet.
There are still some rendering issues (e.g. in the layout of R code output).

Relevant files

• notebooks/index.clj - the tutorial as a Kindly notebook (developed with Clay)
  • dev/conversion.clj - the script used to generate the notebook from the original Rmarkdown tutorial (up to a few additional manual edits)
• docs/index.html - the tutorial rendered using Clay and Quarto -- temporarily served at https://daslu.github.io/tablecloth

Actions

• to render the notebook using Clay (assuming you have the Quarto CLI installed):

(require '[scicloj.clay.v2.api :as clay])
(clay/make! {:format [:quarto :html]
             :source-path "notebooks/index.clj"})

[daslu]

The tests pass now, so the PR can be merged from my perspective.

[daslu]

Quoting @genmeblog on the Zulip conversation:

since my time is limited this week I can't move forward. I don't want to stop you so here is my proposal what to do with merging PR:

• I want to keep current docs reachable somewhere (all artifacts) - so let's move it to the "old" subfolder and update all links (readme + github itself)
• then merge Daniel's branch to enable new docs, also link to it somewhere in Readme.
• since the merge we do not update RMarkdown anymore, changes in docs will be done only in Daniel's version

You have all rights to make the merge - feel free to do this