統合テストと残りのドキュメントをSpring Bootと混在させるべきでしょうか？

Question

Spring Rest Documentation（spring-restdocs）は、Spring Bootを使用しているときのSwaggerの代用として非常に適しています。統合テストをレスト・ドキュメント・テストと混在させたり、いくつかのテストが重複していても別のレスト・ドキュメント・テストを作成する方が良いでしょうか？

Answer 1

これが主に意見ベースのものとして閉じられている場合、私は驚くことはありません。つまり、物事を分かち合うためのケースができると思います。

ドキュメンテーションとその他のテストで使用されたテストは、本質的にかなり異なっています。一般的に言えば、APIを通してゴールデンパスを文書化することだけに興味があり、（多くの）エラーや極端な入力を処理するためのドキュメントを生成することは望ましくありません。

このようにテストを分けておくことで、この違いを意図的に補うことができ、テストの対象となるものを簡単に特定することができます。つまり、APIのドキュメント化や機能の検証です。