[翻訳] コードレビューについて
この記事は::..: glen.nu :.: ramblings :.: on code review :.::の意訳記事です。@9len氏の許可を受けて投稿しています。 This article originally appeared in English at :..:: GLEN D SANFORD :.: RAMBLINGS :.: ON CODE REVIEW ::..: and has been translated with @9len’s permission for posting to this blog in Japanese. この記事は2014年3月に書いている。Twitterでユーザ検索チームを私が率いていたころの話だ。この記事は、コードレビューに関するセオリー・アプローチを体系化することを狙いとしていて、いくつかの基本的なプラクティスの確立を狙っている。あな
write once, publish anywhere ……という夢を見た。
商業品質の紙書籍と電子書籍の両方を作るというミッションを数年来継続し、得られた知見・経験を紹介する。Read less
Code Review Best Practices
At my current company, we do a fair amount of code reviews. I had never done one before I started here so it was a new experience for me. I think it’s a good idea to crystalize some of the things I look for when I’m doing code reviews and talk about the best way I’ve found to approach them. Briefly, a code review is a discussion between two or more developers about changes to the code to address a
Re:VIEWをこうしたい計画（私案） - Qiita
合意は取れてないです。2.0くらいで…と思っているのだけれど、全部やるには時間がかかりそうだから、いっそのこといくつかに切り分けて全部やるのは3.0くらいにするべきかも。 「プロジェクト」の概念を明確化する Re:VIEWはconfig.ymlとcatalog.ymlによる「書籍（≒複数の章の集合体）」を設定するところから始まるのだけれど、簡単に扱うために「章」単位でコンパイルできるようにするしくみもある。が、明確化のためには、書籍単位のデータ・ファイル作成をもっと前面に押し出すべき。 用語としては「プロジェクト」とすればいいような気がする（『はじめてのReVIEW』でも使っていたし）ので、これを公式用語にするのでどうか。 やるべきことは以下。 review-initを使いやすくして推奨する ドキュメントを修正する Webサイト版を作れるようにする WEBMaker（仮）を作って、Webサ
GitHubと連係して動作するコードレビューツール「ReviewNinja」。あの欧SAPがオープンソースで開発中。しかもMEANスタック使用
GitHubと連係するコードレビューツール「ReviewNinja」がGitHub上で公開されています。開発しているのは欧SAP。あの業務アプリケーションで知られるSAPです。 Review Ninjaはまだ開発の初期にあるようですが、GitHub上で次のように解説されています。 ReviewNinja is a lightweight code review tool that works with GitHub, providing a more structured way to use pull requests for code review. ReviewNinjaは軽量なコードレビューツールで、GitHubと連係しています。これはコードレビューの場面でプルリクエストを用いてより構造的な方法を提供するものです。 （一部省略） ReviewNinja defines a clea
オープンソース「Androidの教科書」プロジェクトのお知らせ | TechBooster
TechBoosterはAndroid開発の有志で行うオープンソースプロジェクト「Android Open Textbook」を発起いたしました。 Android Open Textbook は「Androidの教科書」をつくるオープンソースプロジェクトです。 GitHubと書籍制作ツールRe:VIEWを利用して、開発者が欲しい技術情報を集約する試みです。現在、多くのAndroid書籍が発売されていますが、技術の進化は激しく、Androidのアップデートに追従しきれていない現状があります。Android Open Textbookプロジェクトでは、オープンソースプロジェクトとして開発者視点で知見をあつめ、広く一般に提供していきます。 ※Re:VIEWは、電子書籍と紙面の両方をターゲットとした書籍制作の為のプラットフォームです。「Effective Android」をはじめ、「MagicBo
Markdown記法+Git+md2review+ReVIEWで原稿・ドキュメント管理 - プログラマでありたい
来年は、インプットあたりのアウトプットの増加を目指しています。具体的なアウトプットとしては、ブログを書くこともその1つですし、公開・非公開を問わずに効率的にドキュメントを書いていくこともあります。その中で効率的にドキュメントを書くには、バージョン管理を含めドキュメントを管理する仕組みが必須だと思います。以前、原稿を書いていた時は、Git+MS Wordで書いていました。版管理出来るという点では良いのですが、Wordということで執筆出来る端末も限定され、またフォーマット変更もしづらいので改善を考えていました。 そんな中で、IT系の物書きの人たちの間でReVIEW良いよという話を何度も聞いたので試してみようと思いました。一方で、記述のデファクトは今後はMarkDown基本になると思うのでそちらもマスターしたいと考えています。Twitterで何気なく呟いたら、@masawadaさんにmd2rev
【書籍制作ワークフロー】ReVIEW 入門 #07 – ReVIEW 記法 (その他) | DevelopersIO
前回、前々回と、ReVIEWの基本的な記法を学びました。今回はやや特殊な、しかし覚えておくといざというときに使える記法について学ぶとします。 ReVIEW 記法 - 生データ行 ReVIEW は予め定められた記法で書くことで対象となる HTML 要素に変換されるわけですが、この ReVIEW の範囲を超えた特別な要素を組みたい場合があります。その際は以下のように記述することで実現ができます。 //raw[|html|<div class="wrapper">\n<div class="contents">\n<p class="comment">特別なコンテンツです。特別なコンテンツです。</p>\n</div>\n</div>] HTML <div class="wrapper"> <div class="contents"> <p class="comment">特別なコンテンツです。
【書籍制作ワークフロー】ReVIEW 入門 #02 – テキストエディタにシンタックスハイライトを (Sublime Text & CotEditor) | DevelopersIO
ReVIEW 記法でマークアップするテキストファイルは.reという拡張子です。似ているとはいえ、Markdown や Wiki のそれとは記法が異なるので、コレ用のシンタックスハイライトと入力補完が欲しいところです。 そんな訳で、手持ちのテキストエディタがSublime Text とCotEditor なので、この2つにそれぞれ導入してみます。 Sublime Text 用の ReVIEW プラグインをインストール 1) パッケージコントロールをインストール Sublime Text を導入したばかりという方でまだコレを入れていない方は、早々にインストールしてください。（※要・再起動） Package Control Installation 2) Package Control : Add Repository を選択 ⌘ + Shift + pと入力してCommand Paletteを
Sublime Text 2 用の ReVIEW プラグイン作った
ReVIEW とは「テキストマークアップ型の原稿フォーマット」であり html, pdf, epub などの形式に変換することができます。 詳しくは kmuto さんの 「書籍制作フローを変える。 「ReVIEW」という解。[PDF]」 や 「ReVIEWによる書籍制作フローを勉強する会を開いたよ : hdk_embeddedの日記」 を見るといいと思います。 ReVIEW 自体は github で公開されています。 https://github.com/kmuto/review 上記「ReVIEWによる書籍制作フローを勉強する会を開いたよ」内で言及されている Effective Android というコミケ本の制作に関わりました。 この本自体は用意した150部がコミケ3日目開始40分でそうそうに売り切れてしまうという結果になり、現在電子書籍化に向けていろいろ動いているようです。 制作にあ
[review] 7つの言語 7つの世界 - KeN's GNU/Linux Diary(2011-08-23)
View this post on Instagram A post shared by kmuto (@mutokenshi) View this post on Instagram A post shared by kmuto (@mutokenshi) View this post on Instagram A post shared by kmuto (@mutokenshi) View this post on Instagram A post shared by kmuto (@mutokenshi) View this post on Instagram A post shared by kmuto (@mutokenshi) View this post on Instagram A post shared by kmuto (@mutokenshi) View this
![[review] 7つの言語 7つの世界 - KeN's GNU/Linux Diary(2011-08-23)](https://cdn-ak-scissors.b.st-hatena.com/image/square/06a15c64ba0ceec233d86d71001ebb29a9dcbf5d/height=288;version=1;width=512/https%3A%2F%2Fcdn.blog.st-hatena.com%2Fimages%2Ftheme%2Fog-image-1500.png)
ReVIEWワークショップ | Doorkeeper
ReVIEWは電子書籍時代に対応した新しい電子出版システムです。1つのファイルを作成するだけで、複数のファイルを出力できます（現在の対応フォーマットは以下です。自分で拡張も可能です）。 EPUB（およびKindleのmobi形式） LaTeX（およびPDF） InDesign プレインテキスト ReVIEWは、もともと青木峰郎さんが自著の執筆のために作ったソフトウェアです。その後改良が加えられ、書籍（例：オライリー・ジャパンのePUBフォーマットを支える制作システム）や電子書籍（例：達人出版会）の制作現場で実際に利用されています。 また、『リーダブルコード ―より良いコードを書くためのシンプルで実践的なテクニック』（オライリージャパン）・『継続的デリバリー 信頼できるソフトウェアリリースのためのビルド・テスト・デプロイメントの自動化』（アスキー・メディアワークス）・『クラウド時代のネットワ
Cygwinを使ってWindows上でReVIEWを動かしてepubを作る - 結城浩のはてなブログ
前提 Windows 7を使っている。 ReVIEWを動かしてepubを作りたい。 問題 素のWindowsで動かすとうまくいかない。 解決 Cygwinを使う。 詳細 Cygwinをインストールする。 http://cygwin.com/install.html setup.exe zipを入れるため、zipを検索してパッケージをDefaultからInstallにしてから次に進む（あとから改めてsetup.exeを動かしてもよい）。 「ReVIEWクイックスタートガイド」を読む。 https://github.com/kmuto/review/blob/master/doc/quickstart.rdoc Cygwin Terminalを開く。 ReVIEWをインストールする。 $ gem install review 以下のファイルを準備する（すべてUTF-8にすること）。 girl.
Scrum ではコードレビューをどうやっているか？ - haradakiro's blog
森崎先生のソフトウェアレビューの講演を聴いて、今やっているレビューの方法をまとめときたいと思ったので、まとめてみます。今回は、コードレビューの話です。Scrum ではといっていますが、レビューのやり方はチームによって違うので、あくまでも例ですよ。PBI とか、仕様、ドメインモデルのレビューの話はまたこんど。 レビューの目的は、もちろん作成するプロダクトの品質向上です。障害を検出するのも、もちろん目的ではあるのですが、それ以降のスプリントで作成されるコードで同じ障害を作り込まないのが目的としては大きいです。そのため、レビューはプロジェクトもしくはチーム立ち上げ後、数スプリントで重点的にやります。後はスプリントの振り返りでレビューをやりたいが出てきたら、チームで決めます。 レビューのやり方 基本はチーム全員で集まってやります。最大２時間。それ以上やっても集中力が続かないので。プロジェクタで対象
ドキュメント作成ツールの検討(Sphinx、ReVIEWとか) - wadahiroの日記
今後、マニュアルを書いてメンテナンスも継続的にしていく機会が丁度ありそうなので、現時点(2012/05/02)でどのツールが自分たちにフィットするか検討してみた。ツールの候補は以下。なお、過去の仕事ではWordとDocBookは経験あり。 Word DocBook Sphinx ReVIEW 前提 今回のマニュアル作成の前提は以下の通り。 複数人で作業し、1つのドキュメントを作成する(主に章単位でアサイン)。 特定顧客向けに部分的にカスタマイズして提供することもある。 外部向けのドキュメントなので、体裁はそれなりに整っている必要がある。 製品のエディションによってマニュアル構成が変わる(上位のエディションだと機能が増えるので章や節、説明が増えるなど)。 出力フォーマットはWordまたはHTMLならOK。PDFは必須ではない。 ドキュメント中に画像はそれなりにある。スクリーンキャプチャ、構成
秀丸エディタでReVIEW記法を便利に·ReVIEWタグ編集支援 秀丸マクロ集 MOONGIFT
ReVIEWタグ編集支援 秀丸マクロ集は秀丸エディタでReVIEW記法の文書を作成するのに役立つハイライター、マクロ集です。 テキスト記法の一つにReVIEWというものがあります。ePubやLaTeXに変換もできる記法です。そんなReVIEW文書を秀丸で作成する際に使いたいのがReVIEWタグ編集支援 秀丸マクロ集です。 利用には色々な手順があります。まずダウンロードしたマクロファイルを秀丸のプログラミングフォルダに入れます。 次に秀丸で.reファイル（README.reが一緒に配布されているのでそのファイル）を開きます。 そしてファイルタイプ別の設定を開いて、デザインを選びます。 ハイライトファイルを追加するのでReViewという設定を追加します。 ハイライトファイルも配布されているので、それを指定します。 するとこんな感じで色がついてみやすくなります。 次にマクロを一気に設定します。
ePubフォーマットによる電子書籍のラインナップを開始します
オライリー・ジャパンは、このたび株式会社トップスタジオさんと共同で電子書籍専用タイトルの出版を開始します。 現在オライリー・ジャパンでは、販売している書籍のうちおよそ半数にあたる180タイトルの書籍をDRM FreeのPDFフォーマットで販売しています。今回はこれに加えて、ePubフォーマットによる電子書籍専用のタイトルを販売開始します。 2012年1月に発行するのは『Flex 4.5によるAndroidアプリケーション開発』『スケーリングMongoDB』『マネージャーのための仮想化ガイド』の3タイトルで、いずれも50ページから150ページくらいのコンパクトなサイズの書籍。これ以降、毎月数タイトルのペースで刊行を続ける予定です。 今回のプロジェクトでは、トップスタジオの武藤健志さん達が開発に携わるオープンソースのドキュメント処理ツール「ReVIEW」を採用しており、書籍の執筆／翻訳から出版
はじめてのReVIEW〜InDesignへの取り込み - 名もないテクノ手
たいへん遅ればせながらReVIEWを導入しました。著者や編集者が簡易に編集可能なReVIEW記法*1を基に、XHTMLやEPUB、XML、TeX、PDFなどを自動生成するフレームワークです。 昨年発行された『電子書籍で生き残る技術−紙との差、規格の差を乗り越える−』を読んでからReVIEWに大きな関心を持ちました。先月、海上忍さんのコラム「1つのソースでEPUBとPDFを生成できる「ReVIEW」を試す」を拝見して、ヤラねば！ と思いつつずっと宿題だったんです。先日たまたま「ReVIEW の使い方 - A Day in Serenity @ Kenji」を読んでようやく重い腰をあげることとなりました。＜重すぎるだろ... でだ。「ReVIEWクイックスタートガイド」と前述のリンクなどを参考にしてちょろっとやってみたら、簡単すぎて拍子抜けしました。もう、書くことない。 （インストール上で注意
Re:VIEW の使い方 - A Day in Serenity @ kenjis
(2014/03/10)「ReVIEW」から「Re:VIEW」に名前が変わりましたので、変更しました。 Re:VIEW とは？ Re:VIEW は、Wiki に似た簡易フォーマットで記述したテキストファイルから、PDF や EPUB などを生成できるドキュメントツールです。 公式の説明は以下にあります。 https://github.com/kmuto/review/wiki Re:VIEW 記法の簡単な説明は以下にあります。 ReVIEW記法 基本文法最速マスター - 達人出版会日記 とにかくあまり情報がありませんが、かなり優れたツールです。Ruby で書かれている LGPL なオープンソースソフトウェアです。 インストールする Re:VIEW をインストールする Re:VIEW 自体のインストールは簡単です。Git で clone し、パスを通せば完了です。 $ git clone g
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ReVIEWを用いたPDFとEPUBへの変換について
