コメントで原稿をレビューする

質問をソースに紐付け、共同執筆者と話し合い、決定事項を解決済みにして、レビューと編集を分けて管理します。

コメントを使うと、レビュアーはソースを変更せずに文章について話し合えます。各スレッドはテキスト範囲に紐付き、周辺で共同編集が行われても追従するため、主張、手法、数式、キャプションに関する質問に適しています。

レビュアーに適切なアクセス権を付与する#

相手が閲覧と議論だけを行い、編集はしない場合、該当するプロジェクト、フォルダー、ファイル、または選択した複数のファイルを共有し、コメント投稿者 の役割を付与します。コメント投稿者リンクではログインが必要です。文章を理解するために必要なファイルをすべて含めてください。1 つの .tex ファイルへのアクセス権から、その図、参考文献、読み込まれるセクションへのアクセス権が暗黙に付与されることはありません。

議論が不要なら 閲覧者 を使用し、対象のソースを相手が変更する場合にだけ 編集者 を使用します。役割と範囲の境界については、プロジェクトを共有するを参照してください。

焦点を絞ったスレッドを始める#

質問の文脈が分かる最小限の文章を選択します。フローティング表示される 選択範囲の操作 バーで コメントを追加 を選び、判断してほしい内容を書いて コメント を選びます。新しいスレッドがそのソース範囲に開き、サイドバーの コメント にも表示されます。次に例を示します。

この信頼区間は methods.tex に記載されたブートストラップ解析と、パラメトリック感度分析のどちらを使用していますか？

「確認してください」だけよりも、具体的な質問のほうが解決しやすくなります。根拠、関連ファイル、投稿先の要件を示してください。ただし、受信者がほかの方法ではアクセスできない機密情報を貼り付けないでください。

返信、修正、解決する#

サイドバーの コメント を開き、アクセスできるファイル全体の未解決スレッドを確認します。スレッドを選ぶと、そのファイルとアンカーされた文章が開きます。決定の記録が必要な場合は、返信… に回答を入力して 返信 を選びます。編集者がソースを変更した場合は、アンカーが意図した文章を引き続き示していることと、コンパイルまたは表示した結果が正しいことを確認します。

質問への回答が済み、合意したソース変更も反映されている場合は 解決 を選びます。後の編集によって決定が無効になった場合は、解決済みを表示 を選び、スレッドを開いて 再開 を選びます。投稿者は自分の項目で コメントを削除 を選べますが、削除すると文脈も失われます。議論が共同執筆者にとって有用な場合は、削除せず解決済みにしてください。

コメントの更新は、ソースと同じリアルタイム文書で同期されます。ワークスペースがオフラインの場合はタブを開いたままにし、リモートの返信が届いていないと判断したりレビューを閉じたりする前に、オフライン状態が解消されるまで待ちます。メール通知は確実とは限らないため、現在のスレッド状態についてはコメントサイドバーが基準です。

レビューの節目を終える#

多数の修正依頼を受け入れる前に、名前付きバージョンを保存します。レビューが完了したら、投稿を妨げる未解決スレッドがないことを確認し、メイン文書をコンパイルして、レビュー回を示す名前付きバージョンをもう一つ保存します。各決定について、対応するソースとともに解決済みになっているか、担当者と次の対応を決めて意図的に未解決のまま残していれば成功です。 次の改訂回を始める前に、バージョン履歴でこのレビューの区切りを保存してください。