Document %external(\"SomeValue")

[kevanstannard]

We have %external documented on the Special Global Values but I'm not sure if we have the %external(\"SomeValue") syntax documented?

Just noticed this on a recent forum post.

I might have missed it in the docs, otherwise is this something we would like to document?

I am happy to contribute a PR if you think this is useful to document.

Thanks

[ryyppy]

Yeah as you already know, \"" is an escape hatch that can potentially break compiler invariants that hongbo is not too happy about, so we kinda don't advertise this "feature" too much.

Since this is probably very important for class feature detection, I think it would be fine to put another example in there, just like with the AudioContext example (maybe with a note that \"" syntax is an escape hatch to represent capitalized values in ReScript, that would otherwise collide with module / variant constructor names).

[kevanstannard]

Ah, I see what you mean. I'll raise a PR and see what you think.

[kevanstannard]

As discussed in the PR, %raw is preferred over %external so closing this issue.