Jest: Inconsistência nos documentos e nos exemplos

PR # 3172 atualizou os documentos para incluir as novas .resolves e .rejects palavras-chave para executar asserções sobre Promessas.

Percebi que este PR introduziu algumas inconsistências na seção de tratamento de erros atualizada de https://github.com/facebook/jest/blob/master/docs/TutorialAsync.md. Há uma captura de tela desta seção abaixo:

1. Os comentários na parte superior do teste ainda se referem a try-catch , isso é inconsistente com o código contido nos trechos de código.
2. O PR mostra apenas um exemplo com .rejects que só estará disponível em Jest 20+. Isso deve ser mencionado nos documentos para evitar confusão.
3. Pessoas que usam versões mais antigas do Jest não poderão usar esta documentação. Acho que devemos adicionar de volta a explicação sobre o uso de try-catch para capturar a rejeição de Promessa (que foi removida em PR # 3172) para pessoas que usam Jest 19 e inferior. Isso pode estar junto com os documentos atuais usando .rejects .
4. O exemplo contido no link examples/async links para exemplos de teste como este . Esses exemplos ainda usam o mecanismo try-catch , o que é inconsistente com os exemplos de código atualmente contidos nos documentos. Este é outro motivo pelo qual devemos adicionar de volta a explicação sobre o uso de try-catch a esta seção dos documentos.