Há um aspecto do que você está sugerindo que já foi incorporado ao plugin de documentação, o que você pode ver aqui no meta.
Agora ocultamos comentários em tópicos de documentação, caso você acesse-os por meio do índice de documentos.
Veja o botão “Mostrar 33 comentários” no screenshot abaixo:
