RedPen、Asciidoctorを使ったドキュメント作成システムの構築が面白そう

ドキュメント作成の世界にもアジャイル開発の波が押し寄せてきているのでしょうか。「ドキュメント作成システム構築ガイド[GitHub、RedPen、Asciidoctor、CIによる モダンライティング] 」という書籍が出ていたので、購入してみました。Kindle版は「こちら(ドキュメント作成システム構築ガイド Kindle版)」になります。

次のように商品説明がされています。

エンジニアにとってドキュメント作成は避けて通れません。いまやドキュメント作成はコーディングと同様にエンジニアに必要な技術なのです。本書は、ソフトウェア開発の技法に基づいてドキュメント作成を支援するシステムを構築します。このシステムではGitを用いたバージョン管理、GitHubによる共同編集、RedPenによる品質チェック、CIツールによる継続的改善などを用います。

続きを読む

HTTPSのgitリポジトリを提供するサーバでSSLv3を無効にしたらgitコマンドでcloneができなくなった

HTTPSのgitリポジトリを提供するサーバでSSLv3を無効にしたらCentOS6のgitコマンドでcloneができなくなっていて、原因を突き止めるのに時間をかけてしまいました。

$ git clone https://example.jp/git/sample
error:  while accessing https://example.jp/git/sample/info/refs

続きを読む

チーム開発を導入するにあたって悩むこと

チーム開発を導入するにあたって悩むことは多いですよね。いろいろな技術があって使うと便利そうなのですが、うまく活用されるかどうかは、構成メンバーの技術力や心構えに依存するところも大きいので、ただ技術をもちこんだり、ツールを採用するだけではうまくいかないからでしょう。
続きを読む