技術文書をAsciidoc で書いて、GitlabでCIしている話 - Qiita

うちのチームでは、AsciiDoc で仕様書や技術メモを書きGitlab で管理しています。 あるとき、Redpenを紹介されたのを機会に、ドキュメントのCIを回すようにしたので、そのお話です。 AsciiDoc って？ 軽量マークアップ言語の一つです。 以下のような過程を経て、AsciiDocを利用するようになりました。 Word を共有フォルダで管理 重い。差分管理しづらい。同時編集がしづらい Markdown をgitlabで管理 軽い。Gitで編集履歴が簡単に確認可能。 Gitlab上で、整形された状態でプレビュー可能。 方言がある（エディタのプレビューではきちんと表示されても、gitlab上で崩れる） テーブルの編集が大変（特に更新の時が。。。） AsciiDoc をgitlabで管理 軽い。Gitで編集履歴が簡単に確認可能。 テーブル編集が楽。複雑な構造のテーブルもかける。As