コードに仕様書パスをコメントで書くのやめようよ - Qiita

（まず追記） 自分たちで新たに作成する仕様書はMarkdownで記述してGitHubで管理しています。 こんなのも書いたくらいだし、そこは犯していないです。GitHubを中心とした開発プロセス ドキュメント管理 この記事内で言う仕様書とは、「エクセルで作られて共有サーバに置いてあるチーム管理外のファイル」を指します。 こーゆーの、良くあるよね？ public class FooService { /** * 仕様書：ad.xxx.net/development/lorem/ipsum/dolor/sit/amet/consectetur/adipiscing/elit/sed/do/eiusmod/tempor * incididunt_2.xlsx */ public void apply() { } } 見た瞬間「_2.xlsxってなんだよォ...このパス絶対古いんじゃあねェのー？」っ

[yu_dotnet2004]

このアプローチはありかも。

[tmatsuu]

でもそれ、コンパイルした成果物に仕様書情報が埋め込まれて るからぶっこ抜かれる可能性を考えるともにょる気がする。社外に提供されないプログラムならいいけども。