copy

コピー

このスキルでは、インターフェース内の文言を作成し、レビューします。ラベル、説明、ステータステキスト、およびそれらに使われる句読点を対象とします。

大文字・小文字と句読点を厳密に扱う

センテンスケースのラベルは指摘事項です。エムダッシュも指摘事項です。単語を減らせそうなラベルは、短くしても動作が伝わる場合に限り、指摘事項です。

文言以外の余計なインターフェース要素は、restraint の対象です。

ラベルはタイトルケースにする

ボタン、メニュー項目、タブ、見出し、設定名にはタイトルケースを使います。短い冠詞、接続詞、前置詞は、先頭に来る場合を除き、小文字のままにします。「Add to library」は copy-title-case です。

動作が伝わる範囲で最短にする

ダウンロード画面の「Start Download」は copy-fewest-words です。文脈ですでに名詞が示されている場合は、数字だけを表示します。「12 items」は copy-number-not-noun です。

IDではなく、わかりやすい名前を使う

内部の略語や架空のペルソナ名は copy-plain-words です。対象のIDではなく、表示名を示します。セレクト項目内の instagram_graph は copy-display-names です。

説明は1行にするか、表示しない

詳細はすべてツールチップに移します。設定の下に2行の説明がある場合は copy-one-line-description です。

状況に合ったステータスを使う

検索がまだ実行中なのに「検索済み」と表示する場合は copy-state-tense です。

エムダッシュも三点リーダーも使わない

エムダッシュを使う箇所では、コンマかピリオドを使います。これが copy-no-em-dash です。検索プレースホルダー以外では、三点リーダーを使いません。「Loading...」は copy-no-ellipsis です。

ペアで示す

指摘事項はすべてペアです。問題のある行と、それを置き換える行を並べて示します。

ルール	問題のある例	置き換え例
copy-title-case	Add to library	Add to Library
copy-fewest-words	ダウンロード画面の Start Download	Start
copy-number-not-noun	12 items	12
copy-plain-words	PDP	Product Page
copy-display-names	instagram_graph	Instagram
copy-one-line-description	設定の下にある2行の説明	1行にし、残りはツールチップに記載
copy-state-tense	実行中に Searched と表示	Searching、完了後に Searched
copy-no-em-dash	Synced — 2 minutes ago	Synced 2 minutes ago
copy-no-ellipsis	Loading...	Loading

報告

重大度。 HIGH は、ユーザーに表示されるIDや内部用語、または誤った内容を示すステータスです。MEDIUM は、誤った大文字・小文字のラベル、2行の説明、またはエムダッシュです。LOW は、必要な長さより1語長いラベルです。

形式。 根本原因ごとに指摘事項を1件記載します。

file:line - [rule-id] what is wrong

続けて、Rule | Count | Severity のサマリーを記載します。HIGH が1件でも残っている場合は Block、それ以外は Approve とします。読んでいないファイルに Approve を付けてはいけません。実行できなかったチェックにはすべて Not verified と記載します。