unisonweb / unison

A friendly programming language from the future
https://unison-lang.org
Other
5.81k stars 271 forks source link

Use CommonMark-compatible info strings everywhere #5401

Closed sellout closed 1 month ago

sellout commented 1 month ago

Overview

The bulk of this updates transcripts to put spaces around the language name in code blocks. E.g.,

```ucm:hide

becomes

``` ucm :hide

This syntax is already supported by the transcript parser, but it hasn’t been encouraged / shown in examples.

This corresponds to https://share.unison-lang.org/@unison/website/contributions/11, which updates the docs in the same way.

This is effectively a fix for #5214, but that issue also has good recommendations for future changes to info strings, so I don’t know that it should be closed.

Test coverage

You can see the many transcript outputs this affects …