プロダクトのドキュメントをMarkdownからAsciiDocに移行した - GeekFactory

プロダクトのドキュメントをMarkdownからAsciiDocに移行した - GeekFactory

これまでGradle SSH PluginやGroovy SSHのドキュメントをGitHub Flavored Markdown（GFM）で書いていま...概要を表示 これまでGradle SSH PluginやGroovy SSHのドキュメントをGitHub Flavored Markdown（GFM）で書いていましたが、AsciiDocに移行してみました。やったことを記事に残しておきます。 動機 これまでソースコードリポジトリとドキュメントリポジトリを別々に管理していたため、機能追加や仕様変更を行うたびに両方のリポジトリを変更する必要がありました。このため、一つのPull Requestでコードとドキュメントの変更を確認できない、ドキュメントの変更を忘れるといった問題がありました。 そこで、ソースコードとドキュメントのリポジトリを統合することにしました。統合にあたり、せっかくなのでドキュメントを表現力の高いAsciiDocに移行することにしました。 GradleでAsciiDocをビルドする Gradle SSH PluginやGroovy SSHで