Last updated

Project 29

Our migration guide


What made you smile?

  • Much easier than last week's project
  • Focus

What did you find confusing?

  • Wide code sample with diff? Scroll right highlighting is gone
    code-diff-scroll-right.png
  • Webview updates slowly for Shiki code sample changes (while regular Markdown pages are quick) -- this is probably due to what seems like a page refresh.
  • {% highlight is used with both regex to highlight a word (which uses the code word in the comment syntax) and line numbers to highlight lines (which does use the highlight word in comment syntax). Should it be word-highlight?
  • There are some color contrast issues in dark mode for certain code highlights such as diff and warning.
    contrast-issues-in-highlights.png
  • We couldn't get highlight to work with any non-exact match regex, for example: highlight="/id=\".*\"/gm". If it actually doesn't support regex, we shouldn't say that it does in our docs. The Shiki transformer website doesn't use the word regex.
  • highlight={} crashes the webview (without quotes)