The problem with links is what happens x years down the line. In other words, links to external sites can get broken. In contrast, having the contents in the wiki assures that it will be available as long as the code is.
BTW, I don't usually make this suggestion. In fact, I think it's the first time ever. The reason why I think this particular topic would make a good entry is the ridiculous number of issues opened on the subject, alongside the incredible amount of confusion on how it's supposed to work and behave and timings and current etc. Since you wrote it all up, it only makes sense to me that you should be not just the author, but also the committer of the whole thing in the repo. In other words, you would be the author of the official guide on the subject for future users.