タグ

ブックマーク / kkd.medium.com (1)

  • コメントつけたら解決ですか? Wiki第一世代の疑問

    https://flic.kr/p/89xKtT社内Wikiに情報を書くときに守ってほしい、たったひとつのルール という記事がSNSに流れてきたのを見て、ふと疑問に思った。 これって、wikiページの名前が悪いせいではないのか? メソッドに何をしてるかのコメントつけましょうと同じに感じてしまった。 これは、システムAの開発環境を構築するために、Windows 7 にソフトウェアBをインストールした際のメモです。 なら、AのためにWindows7にBをインストールした時のメモってページ名にしておけば済む話な気がするし、 これは、機能Cの設計についてチーム内で議論するために、個人的に作成した設計案です。設計の事前知識として、既存のソースコードを調査した結果も含めています。 であれば(文脈情報ありすぎて全部入れるのは逆におかしい気がするけど)、Cの設計たたき台(議論用)とかにすればいい気がする。

    コメントつけたら解決ですか? Wiki第一世代の疑問
  • 1