十四営業日は、十日と定める第4.2条と矛盾しています。どちらかに揃えるべきです——私は十日のままにして附属書 B を修正する案です。
Qualified Notes on Papers
コメントは必ず届く。
レビューは必ず終わる。
行単位で正確なドキュメントレビュー——未解決がなくなって初めて、レビューは完了します。
見出しを囲むワークフローの情景:ハイライトされた箇所と固定された注釈を持つレンダリング済みドキュメント、レビュアーのコメント吹き出し、注釈が再固定されるバージョン移行、承認された決定、そして未解決の注釈ゼロの完了カード——1本の流れる線でつながり、道中にはレビュアーのアバターが並びます。
いま抱えているそのワークフロー、心当たりがあるはずです。
ドキュメントレビューは多くの場合、ツールとツールの隙間で行われます——そしてその隙間ごとに、コメントが、バージョンが、あるいは午後の時間が失われていきます。
-
qnop なし: ドキュメントがメール添付で送られる。
レビュアー5人、コピー5部、コメント5式——誰かが手作業でマージする羽目になります。
qnop あり: ドキュメントは1つ、レビューは1回、レビュアー全員が同じ場所に。
-
qnop なし: フィードバックが「4ページ目、第2段落、3行目」という形で届く。
直す人は、修正そのものより該当箇所を探すほうに時間を取られます。
qnop あり: 注釈は、意図したまさにその行と領域に固定されます。
-
qnop なし: 新しいバージョンを上げると、旧版のコメントがすべて宙に浮く。
だから安全策は、レビューが終わるまでドキュメントを更新しないこと。
qnop あり: 新しいバージョンは既存の注釈を捨てずに再固定します。
-
qnop なし: レビューが本当に終わったのか、誰にも言えない。
「終わった」とは、誰かがスレッドに返信しなくなったという意味で、作業が完了したという意味ではありません。
qnop あり: レビューを確定できるのは、未解決の注釈がゼロのときだけです。
効くところに精度を、痛いところに構造を。
重労働を担うのは3つ:正確な固定、その場に留まる議論、そして会話を生かし続けるバージョン管理です。
ページではなく、行をマークする。
レンダリングされた PDF の正確な行と領域を選択し、Markdown のスレッドでコメントできます。多層アンカーは引用文・位置・レイアウトを保存するため、注釈は「今日たまたまそこにある座標」ではなく、意図した内容を指し続けます。
- 行・領域単位の正確な選択
- リアクション付き Markdown コメント
- ドキュメントと議論をワンクリックで行き来
議論はその場に留まる。
それぞれの注釈が自分のスレッドを持ちます:返信、リアクション、そして意味のあるステータス。未解決、議論済み、そして承認または却下——決定は誰かの受信トレイではなく、対象となった箇所の上に残ります。
- 注釈ごとの返信スレッド
- 明示的な決定としての承認/却下
- レビュアーの匿名化(オプション)
新しいバージョンが会話を引き継ぐ。
内容の変更は不変の新バージョンを作成します——旧版が書き換えられることはありません。既存の注釈はファジーマッチングで新バージョンに再固定され、バージョン間の差分表示が何がどう動いたかを正確に示します。
- 不変で完全に保持されるバージョン履歴
- バージョンをまたぐファジー再固定
- 比較ビューのためのバージョン間差分
「終わった」と自分から言えるレビュー。
qnop はレビューを、守ってもらうことを祈る慣習ではなく、明示的なステートマシンとしてモデル化します。未完了の作業が残っている限り、最終状態には到達できません。
-
未解決
注釈が箇所に置かれ、回答すべき人に割り当てられます。
-
議論済み
スレッドが進みます:返信、リアクション、判断に必要なコンテキスト。
-
承認 / 却下
決定は注釈そのものに記録され、監査ログに残ります。
-
確定
未解決の注釈がゼロのときだけ到達可能。何も静かにリストから消えません。
レビューをスポーツに
レビューのスループットが、ついに見える。
レビューは誰もスケジュールに入れない仕事です。qnop はその努力を可視化します:ストリーク、スコアボード、実績、プレイヤーカードのプロフィールが、レビューを終わらせることを義務ではなく習慣に変えます。
-
プレイヤーカード
その人がレビューに実際に何を貢献したかを示すプロフィール。
-
ストリークとミッション
仕事がすでにあるダッシュボードの上で、勢いが目に見える。
-
チームティア
チームごとの進捗とリーダーシップランク。実際のレビュー活動から獲得。
ドキュメントはあなたの管理下から離れません。
qnop はセルフホストを第一に設計されています:REST API と組み込み Web UI を実行するコンテナ1つ、PostgreSQL、そして任意の S3 互換オブジェクトストレージ——すべてあなた自身のインフラの上で。
- qnop API + Web UI
- PostgreSQL リレーショナルデータ
- S3 互換オブジェクトストレージ ドキュメント
あなたのインフラ
安全でないデフォルトなし
必須のシークレットが欠けていたり、プレースホルダーのままだと、サーバーは即座に起動を拒否します。忘れ去られる「とりあえず動く」設定は存在しません。
エンタープライズサインイン
メール認証付きのローカルアカウント、または OIDC シングルサインオン。ローテーションするリフレッシュトークン付きの JWT セッションと、レート制限付きの認証エンドポイント。
デフォルトで説明責任
関連する操作はすべて監査ログに記録され、まさにこのために存在する専用の監査者ロールが閲覧できます。
現実に合ったロール
グローバルな管理者・メンバー・監査者ロールに加えて、チームごとのリード——プロセスが求めるなら、レビュアーを匿名化したレビューも可能です。