Engineering(SRE)、ソフトウェア開発、クラウドコンピューティングなどについて、吉澤が調べたり試したことを書いていくブログです。つくるために守ってほしい、たったひとつのルールWikiこのページについてこの記事は、以前書いた「社内Wikiに情報を書くときに守ってほしい、たったひとつのルール」の続編です。全体を信用できるものにする方法について考えます。社内にあって、そこに各人がドキュメント(仕様書や手順書など)を書けるようになっている環境を想定しています。使わないので、具体例もそのような環境に寄っています。全般に通じる話かと思います。「信用できる」と感じました。ホーム画面の上半分を「更新され続ける」ページへのリンク、下半分を「更新されない」ページへのリンクにします。以下は、ホーム画面の例です。「信用できる」ページと「信用できない」ページに分けよう、という話ではありません。信用できないことがはっきりしているなら、そのページは消したほうが良いでしょう。なくて、これは「完全に信用できる」少数のページと、「条件付きで参考にできる」多数のページに分けよう、という話です。以下では、説明のために、もう少し具体的な話をしてみます。「信用できる」とは?この記事で言う「信用できる」という形容詞は、「信用できる技術者」を指すときの「信用できる」と同じような意味だと思ってください。私が知っている信用できる技術者を思い出すと、大抵以下のような長所を備えています。Wiki」になります。「更新され続けるページ」については、そこを読むだけで正確な情報を知ることができて、読み手はソースコードを読んだりする時間を節約できます。「更新されないページ」については、過去のある時点では事実だった(あるいはその書き手が事実だと信じていた)情報ですが、現在では正しいかわからない情報です。その場合も、読み手は、条件付きでその情報を参考にすることで、調査にかかる時間を節約できます。逆に「信用できない」とは?上で挙げた信用できる技術者の長所をひっくり返すと、以下のように、信用できない技術者になります。