タグ

ブックマーク / blog.yux3.net (2)

  • CHANGELOG の書き方 - 角待ちは対空

    VS Code の拡張作っている際に CHANGELOG.md が自動生成され、書き方はKeep a Changelogに従えと書かれていたので紹介する。 ここに書かれていることは絶対ではなくただ提案しているだけである。意見がある人は話し合おうという温度感っぽいので、納得いかない場合は issue 立てると良いと思う。 僕自身はなんでもよくてある程度型が欲しかっただけなのでこれからはこれに従って書いていこうと思う。ただまぁ Semantic Versioning もそうだけどちゃんと従おうとすると以上にだるくなってくるので雰囲気従うくらいだと思う。 CHANGELOG の原則 機械的に生成するのではなく人間の手で書く 各セクションへのリンクが容易にできる 1つのバージョンごとに1つのサブセクションを作る リリースは新しいものが上に来るようにする 日付のフォーマットは YYYY-MM-DD

    CHANGELOG の書き方 - 角待ちは対空
  • レガシーソフトウェア改善ガイドを読んだ - 角待ちは対空

    レガシーソフトウェア改善ガイド (Object Oriented Selection) 作者: クリス・バーチャル,吉川邦夫出版社/メーカー: 翔泳社発売日: 2016/11/11メディア: 単行(ソフトカバー)この商品を含むブログを見る 入社以来比較的新し目のプロジェクトしか触ってこなかったけど、最近はチームが移動になり古めの(古めというか社内最古クラス)のサービスを扱うことになったので、社内で読んでいる人が良さそうと言っていたこともあり読んでみた。 blog.sushi.money hakobe932.hatenablog.com 結果としては非常に参考になった。どうアプローチしていけばいいかの型を提供してくれるであるから、これを元に自分たちにあった方法を模索していきたい。 以下は参考になった部分と感想。 恐れ レガシーなプロジェクトへ 少し変更するだけでぶっ壊れてしまう 修正が必

    レガシーソフトウェア改善ガイドを読んだ - 角待ちは対空
    lEDfm4UE
    lEDfm4UE 2017/02/19
  • 1