プロジェクトのドキュメント作成¶

本ドキュメントは、アスキー・メディアワークスから2010年5月31日発売のエキスパートPythonプログラミングの10章のサンプルです。原著でも10章がサンプルとして公開されていますが、翻訳書でも10章を公開できる運びとなりました。

テクニカルドキュメントの書き方から、ドキュメントの種類など、ソフトウェア開発におけるドキュメンテーションについて、幅広く説明されています。最後にSphinxについても説明されています。

• PDF版サンプル: 出版されるレイアウトです。
• ePub版(iPad用)サンプル: Sphinxで生成しました。

Python Enhancement Proposal: 1¶

PEPというのはPythonの機能拡張、要望、リリース計画などを記述するのに使用される公式なドキュメントの記述方法です。オープンソースの中でも屈指のドキュメントの充実ぶりを見せるPythonのコアとなる部分で、「開発コミュニティを動かすドキュメント」です。PEP 1は、その中でも、PEPのワークフローを定めたメタなPEPです。

最近ではErlangもPythonに習って、EEPとして取り入れています。

Python Enhancement Proposal: 3120¶

このPEPはデフォルトソースエンコーディングをASCIIからUTF-8へ変更することを提案します。代替となるソースエンコーディング、つまり明示的なエンコーディング定義をデフォルトよりも優先することは継続的にサポートします。