techdoc-ja 日本語で技術ドキュメントを記述する環境整備 | DevelopersIOよく訓練されたアップル信者、都元です。弊社は本日を最終営業日として、これから冬季休業となります。 今年も一年、どうもありがとうございました。というわけで書き納めの一本、その3。 最近ドキュメントを書く機会が増えてきました。 仕様書は Markdown で書きたいですね。そして GitHub を使って書き進めたいですね。 PlantUML で簡単に作図ができるといいですね。図中では日本語も使いたいですよね。 さらに機械的に実行できる校正は、自動チェックしたいですね。 書き上がったものは自動的に HTML や PDF にして、S3 にデプロイしたいですね。 という一連のジョブは CI で実行したいですね。 という思いを実現するための環境を整えたので、ひとまず公開します。 どうやって実現するか GitHub で Markdown は、まぁ単に書けって話ですよね。 書いたコンテンツは gitboo
