A FAQ seems like a not so good idea. FAQs almost always are quite incomplete and go out of date over time. We used to have one a long time ago IIRC, and it was exactly like that - a random grab bag of stuff with mostly outdated specific problems.

For topics like threading and numerical precision, it'd be great to have good docs pages, that will be quite valuable. That still solves the problem at hand here (you can link to the relevant page) without starting a FAQ.

Note that there is already https://numpy.org/devdocs/user/troubleshooting-importerror.html, which has already started degrading, a number of entries haven't been relevant in quite a while.

+1 For the idea. I can get started working on this if help is wanted.

Instead of an FAQ, adding a couple pages to the "Advanced usage and interoperability" section of the main ToCtree or to the https://numpy.org/devdocs/dev/underthehood.html section sounds like a good idea.

I think the best strategy would be for someone to have a chat with @seberg and pick his brain on the main things to mention - maybe at a docs meeting?

@melissawm The "Advanced usage and interoperability" section sounds like a good idea, but please can you shortly summarize what the discussion here is about? I want to contribute and think about it.

You can look through the issues for problems with OpenBLAS threading and oversubscription, like #27174, #27605, #16990. Numerical floating point precision comes up in issues like #23733, #25269, #27782. There are more.