ドキュメント作成システム構築ガイド を読み終えたので、その感想です。GitHubとCIサービスの組み合わせ方、gitやmarkdownの初歩的な使い方も丁寧に書かれているので、意外と新人向きの書籍かもしれません。 発売前に、エクセルで手順書を作るのはきっとやめた方がいいという自分の投稿に、その解決策としてCIに沿ったライティングの情報を追加したのですが、それが著者のお一人の目に留まったらしく、なんだか恐縮です。 概要 ソースコードの品質を高めるために、継続的インテグレーション(CI)が導入されてきたように、ドキュメントに対してもそれをやろうというものです。そのために バージョン管理システム(Git) Gitで差分が見やすい軽量マークアップ言語(markdown,asciidocなど) 文章を校正するためのツール(RedPen,textlintなど) PDFやHTMLなどに出力するためのツー
![技術ドキュメントにもCIを~「ドキュメント作成システム構築ガイド」を読んで ~ - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/d2c1d294b7bec559c93c59a2b7fc0d1d9613c658/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-9f5428127621718a910c8b63951390ad.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTkxNiZoPTMzNiZ0eHQ9JUU2JThBJTgwJUU4JUExJTkzJUUzJTgzJTg5JUUzJTgyJUFEJUUzJTgzJUE1JUUzJTgzJUExJUUzJTgzJUIzJUUzJTgzJTg4JUUzJTgxJUFCJUUzJTgyJTgyQ0klRTMlODIlOTJ-JUUzJTgwJThDJUUzJTgzJTg5JUUzJTgyJUFEJUUzJTgzJUE1JUUzJTgzJUExJUUzJTgzJUIzJUUzJTgzJTg4JUU0JUJEJTlDJUU2JTg4JTkwJUUzJTgyJUI3JUUzJTgyJUI5JUUzJTgzJTg2JUUzJTgzJUEwJUU2JUE3JThCJUU3JUFGJTg5JUUzJTgyJUFDJUUzJTgyJUE0JUUzJTgzJTg5JUUzJTgwJThEJUUzJTgyJTkyJUU4JUFBJUFEJUUzJTgyJTkzJUUzJTgxJUE3JTIwfiZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTU2JnR4dC1jbGlwPWVsbGlwc2lzJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnM9YzM3YTJmNjQ4MDFkYTU0MjIyZjg1YzBjMzRmOTcwZTk%26mark-x%3D142%26mark-y%3D112%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTYxNiZ0eHQ9JTQwbl9zbGVuZGVyJnR4dC1jb2xvcj0lMjMyMTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9MzYmdHh0LWFsaWduPWxlZnQlMkN0b3Amcz03MTZkY2FlMzQ5NTEzNTQwZGM0ZmU3ODQ1ZjQ1OWRjYg%26blend-x%3D142%26blend-y%3D491%26blend-mode%3Dnormal%26s%3D46ebd6293389eded348ac2c330502d5b)