In reply to @nnsee "re: `pinToCPU` - i": >  i personally think library
documentation should be educating the user on general computer science stuff but
rather be terse enough so that people who do need to use it can find it and use
it successfully.

100% agree! Would love much more of that.

Here's what I think a much better example of "this is complicated and dangerous"
could look like: https://wiki.libsdl.org/SDL3/CategoryAtomic

There's actually some explanation here, telling people what they should be
doing, along with links to some great articles that explain the problem
(seriously, read that first Microsoft one, it's phenomenal).

The example from the Nim documentation is just too terse to be informative. It
tells you not to use it, but gives you nothing on leveling up so that you
_could_ use it.