Board Thread:Watercooler/@comment-24473195-20150915112607/@comment-11733175-20150915171505

Most of the linked comment there is about gadget definitions, it's not very on topic for this. His note that documentation pages based on a message value is probably correct assuming it's based on experience of the issues that have arisen as a result of that decision, but as I mentioned above, implementing something too different causes it's own issues with upgrading. It means instead of being able to simply upgrade something you have to work with conflicts which may or may not resolve easily and then may cause hidden issues not noticed during testing. It doesn't help that MediaWiki and Wikia use separate testing frameworks so Wikia can't just test the same code once they've finished altering it.

I'm not saying that the /doc idea is perfect, but you haven't actually provided any argument for why it's bad.