新しいプロジェクトを開始するにあたり、 ExcelやめてSphinx + reStructuredTextでドキュメント作るようにしません? という提案をしてみたら、意外とすんなり通った。 概要 — Sphinx 1.5.6 ドキュメント reStructuredText入門 — Sphinx 1.5.6 ドキュメント これでドキュメントのバージョン管理とか、 複数人での共同作成とかがしやすくなりそうで嬉しい。 この提案の前に、 チーム内でのちょっとした技術情報とか議事メモの共有に Markdown形式のファイルを使うようにしていて、 テキスト形式の文書管理に抵抗がなかったのが良かったのかもしれない。 で、どうせならこれまでMarkdownで作成したファイル(結構作ってた)も reStructuredTextに変換して、SphinxでHTML化して閲覧できるようにしたい! ということで今回
![既存のMarkdownファイルをreStructuredTextに(ざっくりと)変換する - ほんじゃらねっと](https://cdn-ak-scissors.b.st-hatena.com/image/square/546f15f7fc8706ed01046e2645b6e129bd26ecb0/height=288;version=1;width=512/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fp%2Fpiro_suke%2F20160827%2F20160827004244.jpg)