スキーマ定義ファイルにテーブル・カラムコメントを書く
これ、公式サイトにも記述ないと思うんだけど、隠れ機能?
たまたまOpenPNEのTracチケットを見つけて気づきました:
#4232 (Doctrineのスキーマ定義にテーブル・カラムのコメントを記述する) - OpenPNE - Trac
テーブルコメント
options: 設定の中で、comment:を指定できる。
User: options: comment: "ユーザテーブル" columns: ………
カラムコメント
各カラムの中で、comment: を指定できる。
User: columns: email: comment: "メールアドレス" type: string(255)
こうしとくと、phpMyAdminでコメント見れてわかりやすいし、
ERMasterでDB定義書を出力するときに反映するので、とても良い感じだ。