本日18:30から行われるYokohama.pm #7へ参加する予定です。 Sphinx + blockdiagで始めるドキュメント生活 / @tk0miyaさん 資料は後でTweet予定 ドキュメントの種類 納品物としてのドキュメント = お客さんのもの 設計/運用のためのドキュメント = 自分たちのもの 後者が足りない → 辛い現実 ドキュメントのメンテ テーブル定義、機能、画面キャプチャがドキュメントに更新されない メンテが必要 → Lightweight が大事 Lightweight なドキュメント Sphinex、Wiki、ソースに書く、テンプレ化 Sphinx reST形式で書く→XMLやLaTeX、PDF、HTMLなどに変換 Python製 reST形式 → 「====」とか「----」とか「*list」みたいなマーキング makeでビルド コードハイライト機能 → Per