It’s an excellent idea. Some time ago we discussed something similar at a community meeting, and I’d planned to create a wiki page for the purpose, but unfortunately I never got around to it.
At this point, your suggestion of adding it to the docs would seem like a better idea.