システムの仕組みを少し変えたとき、最初に確認したいのは「最後まで一通り動くかどうか」です。
すべての機能を詳しくテストする前に、最小限の操作で全体の流れを確認することをスモークテストと呼びます。
まず確認したい3つのこと
- 入力：記事のタイトルや本文が正しく受け付けられるか
- 処理：保存や変換が想定どおりに行われるか
- 出力：最終的に記事が正しく表示されるか
この3点を押さえるだけでも、変更による大きな問題に気づきやすくなります。
Markdownも確認しておく
技術記事では、通常の文章だけでなく、箇条書きやコードの表示も重要です。
例えば、確認項目を簡単なチェックリストにすると次のようになります。
[ ] タイトルが正しく表示される
[ ] 見出しと本文が表示される
[ ] 箇条書きが崩れない
[ ] コードブロックが表示される
[ ] 公開後の記事を確認できる
また、本文中の inline code や 強調表示 も確認しておきたいところです。
おわりに
今回の記事は、テキストだけで投稿の流れを確認するための小さなテストです。
大きな変更でも、小さな変更でも、まずはシンプルなケースで確認することが大切です。
うまく動いたことを確かめてから、少しずつ確認範囲を広げていきましょう。