I'm experimenting with adding inline hints to indicate stuff like parameter names in code example on the documentation I'm writing. I got a shiki custom transformer going to replace inline comments that look like
/* [!hint: prop:] */
/* [!hint: prop:] */
by
prop:
prop:
. Obviously they get automatically removed from the
copy code
copy code
functionality.
I personally like those in my IDE as it makes it easier to understand what is what on function calls, but some questions comes to mind : - is it helpful on a code example ? - should I add a way to hide them ? - are they readable enough ? - is it clear enought that they aren't actually part of the code ?