環境構築してみた系の記事を書くときに気を付けていること

概要 先日F* のインストール+実行可能コード生成までの手順(2022年)という記事を書きました。この記事では F* という言語の開発環境を整えるための、再現可能な手順を紹介しました。 この記事では、環境構築系の記事を書く際に、読者にとって有益な記事とするために私が気を付けていることを紹介します。 読者が追走可能なようにする 記事執筆者と読者の間で環境が異なっていた場合、同じ手順を実行しても同じ結果が得られないことがあります。 そのため、どのような環境を用いたかを明記して手順の再現可能性を高めることが重要です。 使用した環境・アプリなどのバージョンが何なのかを記載する 先日の記事内で参照しているログでは、自分がどのような環境で実験したかを書き残しています。 事実だけではなく、それをどのようなコマンドで取得したかも明記する 上のリンク先では、環境のバージョンをどのコマンドで取得したかも記載し