Multi color highlighting

[awdeorio]

Multi color highlighting

[seshrs]

Thanks for the feedback! Yes, I definitely see the issue with explaining large codeblocks.

I’m hesitant about whether multi-color highlighting is the best solution though, especially from the point-of-view of accessibility (for students with color vision deficiencies).

Instead, what do you think about “callouts” that appear inside the codeblock and appear in the margin or to the right of the code? I’ll need to look for examples on other websites and give some thought to the API…

[seshrs]

Ah ha, found an example of “annotations”: https://squidfunk.github.io/mkdocs-material/reference/code-blocks/#adding-annotations

Though I think I’d choose a slightly different API, and make it possible to add multi-line annotations.

Aside: I also really like Docusarus’ implementation of “magic comments” for highlighting ranges. I think I can implement that too! https://docusaurus.io/docs/markdown-features/code-blocks#highlighting-with-comments

[awdeorio]

Thanks for pushing back with better suggestions!

Ah ha, found an example of “annotations”

So basically pop-ups inline with code. One downside is that it might not be obvious that you should read this.

magic comments” for highlighting ranges.

Is the idea that you click something to change which lines are highlighted? That's cool! You could show 1 block of code. Show default (first) highlighting. Explain it in the following paragraph. Then in the next paragraph say "now we're talking about this other chunk. There's a link that causes the highlighting to shift.

[seshrs]

Is the idea that you click something to change which lines are highlighted?

Oh hmm, I hadn’t thought about that. I’ll need to think a bit more about that one.

Regarding magic comments, I was referring to using code block comments to indicate which lines should be highlighted, instead of specifying line numbers. (It would be easier for you as a spec author to see which lines are highlighted.)

[awdeorio]

Regarding magic comments, I was referring to using code block comments to indicate which lines should be highlighted, instead of specifying line numbers. (It would be easier for you as a spec author to see which lines are highlighted.)

Meh, I could take it or leave it with the magic comments.