I'm not sure which conversation you're referring to, but my general opinion is that information useful to quest authors should go in external docs, and information only relevant to developers is best incorporated in the source where it's most likely to be seen and maintained.