I personally think it should be documented everywhere. I mean, unlike code, documentation should not fear the duplication. Important pieces of documentation/insight shall be repeated in as many places as possible (kdocs, guides, wikis, SO, etc) to maximize the chances of people stumbling upon it.