[常識にしたい]PDFにコメントするときの鉄則

なぜかちゃんと知られていない、PDFへのアノテーション（=校正などで使用するツールやコメントなど）を使う時のエチケットをメモする。自由過ぎるアノテーションにお引き取りいただくために。

この鉄則は、今なら[Zeplin](https://zeplin.io/)のようなツールにも応用できる。

## 作業前に

アノテーション機能はPDFビュアーによって異なるけど、ここではAdobe Readerを前提とする。**作業者のビュアーを全員同じにしておくこと**。でないと無駄な争いが起きる。Mac/Win/Linuxで共通に使えるAdobe Readerにしておくのが無難。

## 鉄則1: バルーンは「絶対使うな」

例外はあるにせよ、ちょっと強い調子で書く。バルーンを使うと**確実に嫌われる**。
![Balloon.png](https://qiita-image-store.s3.amazonaws.com/0/20266/f0af5fa0-288c-73b0-dac2-90ab907c53b5.png)

バルーンは、**画面や文字列のどこを指しているのかが必ずあいまいになる**。そしてそれが元で必ずや修正指示が食い違う。

バルーンの利用が許されるのは、この特性を理解したうえで、最初のページの空きスペースあたりにグローバルな指示を付けるときに限られる。

## 鉄則2: 1つの指示にアノテを2つ以上使わないこと

**1つの修正指示は必ず1つのツールだけで行うこと**。さもないと、修正が全部で何件あるのかをカウントできなくなり、作業時間も見積もれなくなる。

1つの修正指示にいくつもいくつもツールが使われていて、実際に修正が必要な箇所はその5分の1もなかった、などということはざらにある。

そのようなことをしていたら、アノテ情報をエクスポートしてもほとんどが中身が空のゴミ情報と化してしまう。

修正箇所を示すためにわざわざアノテの棒を4つも5つも使って矢印らしきものをこしらえ、「[ここだよここ](http://www10.plala.or.jp/shigezou/char_ru/framePP_02.html)」と得意気に修正指示を出してくる人がいる。あなたが疲れるだけでなく、**指示を出される側にとって大変迷惑なので**、即刻やめること。

<img width="663" alt="multipleannotation.png" src="https://qiita-image-store.s3.amazonaws.com/0/20266/97d7c6d8-4cd2-d610-b504-864bdd9ab813.png">

## 鉄則3: 文字列の修正指示には「取消」「置換」「挿入」ツールだけを使うこと

（画像でない）文字列の修正指示には以下の「取消」「置換」「挿入」ツールだけを使う。それ以外のツールを絶対使わないこと。

<img width="693" alt="tools.png" src="https://qiita-image-store.s3.amazonaws.com/0/20266/8484c7d1-5b1e-55d9-1384-2576faa93d5b.png">

「取消」「置換」「挿入」ツールは上の3つ。PDFアプリケーションによって呼び方は違ったりする。

### 取消ツール（strikeout）

<img width="455" alt="strikeout.png" src="https://qiita-image-store.s3.amazonaws.com/0/20266/85703e89-70c7-b186-c584-f485c9162ee3.png">

上の図でわかるように、消したい文字にこの取消線を追加する。このコメント窓に下手に何か書くと、そのご意見がそのまま間違って入力されたりするので、**何も入力しないこと**。「トルツメ」とも書かないこと。このツール自体が「トルツメ」なのだから。

### 置換ツール（replace）

<img width="437" alt="replace.png" src="https://qiita-image-store.s3.amazonaws.com/0/20266/b97822e8-19cd-0574-2d53-89cab04b2cdf.png">

同じく、置き換えたい文字列には置換ツールで指示する。コメント窓には「置き換え後の文字列」**だけ**を書くこと。「〜に置き換えてください」などと余計なことを書くと、その指示まで一緒に置き換えられてしまう。

### 挿入ツール（insert）

<img width="351" alt="insert.png" src="https://qiita-image-store.s3.amazonaws.com/0/20266/30ae92f9-83f4-c2a3-4109-8587721878a1.png">

同じく、文字列を追加するには挿入ツールで指示する。コメント窓には「追加する文字列」**だけ**を書くこと。「〜を挿入してください」などと余計なことを書くと、その指示まで一緒に追加されてしまう。

## 鉄則4: コメントしたいことがあったら「返信」の形で付けること

鉄則3で述べたように、挿入・置換する文字列には**一切余分なものを付けてはならない**。どうしてもコメントしたいなら、アノテに「返信」する機能がちゃんとあるので、常にアノテへの「返信」としてコメントすること。

<img width="361" alt="reply.png" src="https://qiita-image-store.s3.amazonaws.com/0/20266/d761101d-56eb-a755-c1c1-8902e8fa0d05.png">

こうすることで、挿入・置換する文字列とコメントが混じって扱われる心配がなくなるうえ、返信はアノテの個数にカウントされないので、修正箇所を正確にカウントできる。

> 今どきは修正を反映してくれる方はたいてい「**日本人ではない**」ことを十分理解しておくこと。なので、「どこからどこまでが指示なのか、そのぐらい見りゃわかるだろが」などという20世紀のオヤジ臭いクレームは一切通用しないと思うべし。このルールではそのことを最初から考慮しているので、そこのところよろしく。


## 鉄則5: 改行の変更指示は折れ線ツールを1度だけ使うこと

改行は「折れ線ツール」を1つだけ使って表現する。追加指示を言葉で書くときは、前述のとおり「返信機能」で行うこと。

<img width="377" alt="linefeed.png" src="https://qiita-image-store.s3.amazonaws.com/0/20266/51793153-d7ac-4717-13d5-2ce78a165f23.png">


## 鉄則6: その他の修正指示には四角ツールを1度だけ使うこと

ここまでの鉄則から導けると思うけど念のため書く。上記以外の修正指示でも、四角ツールなどのツールをひとつだけ使う。指示も同様に「返信」で追加する。

<img width="877" alt="recttool.png" src="https://qiita-image-store.s3.amazonaws.com/0/20266/d55a5a66-6db1-d427-4a9d-cce68256af45.png">

なお「パラグラフや図を次のページや前のページに移動せよ」みたいな指示だと、ツールひとつで表すのがどうしても困難なことがたまにあるかもしれない。要素がいくつもあって間違えそうなときに限り、移動先を四角で囲んで示す。

なおこの鉄則で使う四角はいわゆる以下の「長方形ツール」のことであり、**「テキストボックス」ではない**のでお間違いのなきよう。

<img width="262" alt="rect.png" src="https://qiita-image-store.s3.amazonaws.com/0/20266/65e95f45-b977-783f-0321-2e7e2b1866d6.png">


「テキストボックス」や以下のような「リード付きテキストボックス」などというものもあるけれど、**記入内容が「指示」なのか「置き換え用文言」なのかが必ず紛らわしくなる**ので、使用しないこと。

<img width="264" alt="leadtextbox.png" src="https://qiita-image-store.s3.amazonaws.com/0/20266/074bb668-e12f-9396-63f2-d740729c6bc9.png">

繰り返す。「ツールは一度にひとつ」。

## 鉄則7: 指示を「疑問形」で書かないこと

指示で「どうしてこうなったんですか？」「〜は〜ではありませんか？」などと意味もなく疑問文で書くと、入力も手間なうえにやり取りが1往復増えて**時間の無駄にしかならない**。指示された側も、指示なのか質問なのか単なる皮肉なのかを判断するために余計な時間がかかる。極端な場合、修正していいのかどうかはっきりしないので問い合わせないと先に進めなくなることすらある。即刻やめること。

- 日本語なら「〜へ移動」など、**体言止め**で書く。「〜してください」などと書くよりタイプ量が減るので。
- 英語で指示するなら「Move 〜」や「Change color to red」のようにすべて**命令形で書く**。同じくタイプ量を減らす効果がある。命令形で書いても別に無礼ではないし、please を付けても丁寧になるわけではないので無駄なことを書かないように。言いたいことがあれば例によって「返信」で書くこと。

質問しないと先に進まないなら、ラベルの色を変え、返信を「要回答」で始めるなどして、質問であることがはっきりわかるようにする。こうすることで、アノテーションで「要回答」やラベルの色でフィルタすれば質問だけを確認できる。

同様に、否定形も意味なく使わない方がいい。常に「何をどうする」と具体的な指示だけを書く。「〜するな」など、否定文はしばしばスコープがあいまいになるので、解釈がぶれると無駄な修正や修正不足に陥る。

読む人が小学生の女の子だろうとインド人であろうと、確実に作業できる指示にすること。

# 最後に

以上を守ることで、PDF 修正・ウェブページ修正・デザイン修正が大規模になればなるほど、作業効率が急上昇する。ぜひお試しください。

もっといい方法があればぜひコメント欄にお知らせください。

それでは皆さん、どうぞ早くお家へお帰りください。