Update: Indentation woes

[codebykat]

Fix

In #3216, I changed Monaco's wrappingIndent to none in order to address a request to support hanging indents on paragraphs. Unfortunately this also removes the indentation from lists, making lists less readable.

Some further research in #3053 (comment) but basically I think we were better off with the default of same. There's no way to indent paragraphs, sadly, as even a single space gets matched by the word wrapping algorithm (which is not affected by the settings for detecting indentation settings, tab size, etc.).

Monaco/VS Code does not support these things I've thought of as workarounds:

• Different word wrap settings for lists and paragraphs
• Using CSS to apply styling to only the first line
• Different word wrap settings for different languages
• Using the tokenizer to adjust the indent size
• Language settings for indent/outdent applying to the word wrapping indent

Here are some relevant upstream issues: microsoft/monaco-editor#3914, microsoft/vscode#219680, microsoft/vscode#169804, microsoft/vscode#164267

Anyhow, this PR represents a partial revert of #3216, as maybe the least terrible of the available options. I think that indent is a deal-breaker due to representing a serious departure from expectations for long-form writing, whereas a hanging indent on paragraphs is more of a "nice to have" for that use-case. Meanwhile for lists, none is pretty bad, probably(?) worse than the weird behavior of indenting entire paragraphs that we get with same.

Which is a complicated way of saying that same is optimal for lists with word-wrapping, none is optimal for paragraphs, and we can't switch our strategy depending on which it is we have, so we have to pick a side.

Other considerations:

• An initial indent gets perceived by the Markdown preview renderer as an indication of a code block. List items that aren't indented, and their nested children, are safe -- but indented list items that don't have an un-indented parent are not.
• The native apps apparently support an initial indent on paragraphs, which then indents the entire paragraph when viewed on web/desktop.

Screenshots

Here are the three options and their trade-offs.

Release

Release notes updated with:

Remove hanging indent support due to its detrimental effect on word-wrapped list items.

n.b. I've added this to a new minor version, 2.23.3, but it could arguably be a hotfix for 2.23.2.