Hay un aspecto de lo que estás sugiriendo que ahora está integrado en el plugin de documentación, y puedes verlo aquí en meta.
Ahora ocultamos los comentarios en los temas de documentación si los accedes a través del índice de documentación.
Mira el botón «Mostrar 33 comentarios» en la captura de pantalla siguiente:
