feat: bootstrap bikeshed

[kburger]

Added an index.bs scaffold to demonstrate the use of bikeshed. Locally this can be run using:

bikeshed spec index.bs output.html

Note that the output is not on par with the existing index.html, because bikeshed is opinionated. With some css we can probably get closer, but that is out of scope for this PR.

Up for discussion:

• folder/file structure and naming convention (folder per chapter, .md file naming)
• bikeshed metadata (which keys to use, what values to pick)
• look-and-feel
• github action automation (see https://speced.github.io/bikeshed/#gh-action-ci)

fixes #19 (?)

[kburger]

I'm converting the remaining chapters in this PR to keeps things together.

[kburger]

@luizbonino and @dennisvang, i'm looking for feedback on setup, naming, and what we're missing out on look and feel.

[dennisvang]

Hi @kburger, looks good already. :)

Not done reviewing, but some notes for now:

• I've added some project dependencies for local dev in Specify project dependencies #21. Just a suggestion.
• One thing I've noticed in the bikeshed output is that a "Conformance" section is generated, near the bottom.
  In the new spec we should probably move the info from the "Compliance" section into that "Conformance" section, and move it to the top somewhere.
• Would it be possible to convert the tables to markdown too, instead of html? I know this will lead to long lines of text again, but in this case I'm inclined to prefer readability of the raw markdown document.

[kburger]

@dennisvang bikeshed support commonmark, which does not include tables (see speced/bikeshed#2857 and speced/bikeshed#1128). When a markdown table is written once, and read many times I agree, but if a table needs frequent updates the maintenance of a markdown table can be cumbersome.

For the conformance section, I think it can be influences by configuration settings. That would be something to investigate.

[dennisvang]

@dennisvang bikeshed support commonmark, which does not include tables (see speced/bikeshed#2857 and speced/bikeshed#1128). [...]

Thanks for pointing that out. I was not aware that md tables are not supported.

[...] When a markdown table is written once, and read many times I agree, but if a table needs frequent updates the maintenance of a markdown table can be cumbersome.

Yes you're right.