対象
documents/forPerformanceTest/performance_test.md の「目標値を明確にする」内、スループットに関する記述。
スループットの目標値の定義にあたっては、処理時間の定義と同様のアプローチを取る。
論点
参照先である「処理時間」の節が、スループットの節より後ろにある。読者は、まだ説明されていないアプローチを参照させられることになる。
対応案は次のいずれか。
- 節の順序を入れ替える(処理時間 → スループット)
- 前方参照であることを明示する(「後述の処理時間と同様のアプローチ」など)
- スループット側にもアプローチを簡潔に記述する
経緯
ライティングレビュー ロット13(#374)の著者確認事項として挙がったもの。節構成の変更を伴う可能性があるため、Issueとして切り出した。
対象
documents/forPerformanceTest/performance_test.mdの「目標値を明確にする」内、スループットに関する記述。論点
参照先である「処理時間」の節が、スループットの節より後ろにある。読者は、まだ説明されていないアプローチを参照させられることになる。
対応案は次のいずれか。
経緯
ライティングレビュー ロット13(#374)の著者確認事項として挙がったもの。節構成の変更を伴う可能性があるため、Issueとして切り出した。