記号（括弧、句点、スペースなど）の表記

括弧や句点、スペースの使い方などを定義しています。

「！」と「？」は単独で使う場合は全角、ペアで使う場合は半角で表記する

説明

「！」「？」「!?」「!!」という単位で1文字に相当するため、「！」「？」は全角で表記し、「!?」「!!」は半角で表記します。
「！」「？」の後に文章が続く場合は、「！」「？」の直後に全角スペースを挿入してください。
詳しくは、記述記号は全角を使用するを参照してください。

見出しでは句点（。）を省略する

説明

見出し（Heading）では、「。」は省略します。
同様に、例を示した場合の、名詞や「など」の後ろでは句点はつけません。

UIテキストでは、それぞれのコンポーネントごとのルールを参照してください。

議事録

https://kufuinc.slack.com/archives/CJX59GJFR/p1605150202129600

箇条書きの場合の句点（。）の使い分け

説明

単語を箇条書きにする場合は、「。」を省略します。
文章を箇条書きにする場合は、「。」をつけます。

議事録

https://kufuinc.slack.com/archives/CJX59GJFR/p1691645627079309

複数の語句を列挙する場合の、読点（、）とナカグロ（・）の使い分け

説明

列挙の順序に意味があるときは、「、」を使用します。
順序を入れ替えても構わないときは、「・」を使用します。

使い分け例

信号は青、黄、赤の順に点灯する。
信号には青・黄・赤の三色がある。

具体例

被保険者整理番号、マイナンバー、基礎年金番号のいずれかが必要です。
※上記は、CSV形式の算定基礎届を取り込んだ際のエラーメッセージ。CSVの項目（列）を入れ替えできないので「、」を使用。

出典

数学文章作法基礎編の「2.4語句」

数字と英単語の前後に半角スペースを挿入しない

説明

和欧混植の文章内の英単語と、数字の前後には半角スペースは入れずに詰めましょう。

例

OK：PDFファイルをアップロード
NG：PDF ファイルをアップロード

OK：2020年の年末調整
NG：2020 年の年末調整

記述記号は全角を使用する

説明

記述記号は全角を使用します。例外はありますが、基本的に記号の前後にスペースを挿入しません。
使い分けは下記の表を参照してください。

記号の前後にスペースを挿入しないケース

記述記号	種類	例
区切り符	`・`（中点、ナカグロ）、`｜`（バーティカルバー、パイプ）、`：`（コロン）、`／`（スラッシュ）	`ステップ１：`
句読点	`、`（読点）、`。`（句点）	`ユーザーA、ユーザーB`
括弧類	`（）`、`「」` 、`［］`、`【】`	`［削除］を押します。`
つなぎ符	`―` （ダッシュ）、`…`（三点リーダー）、`〜`（波線）	`対象範囲：A〜B`

記号の後のみ、全角スペースを挿入するケース

「？」「！」の後に文章が続く場合は、「？」「！」の直後に全角スペースを挿入します。
全角スペースを用いることで、疑問文や強調する文のカタマリを識別しやすくなります。

記述記号	種類	例
句読点	`？`（疑問符）、`！`（感嘆符）	`以下の{オブジェクト名}を削除しますか？この操作は元に戻せません。`

ただし、ヘルプページの「よくある質問」などで質問文を見出しに使う場合は、？の後にスペースを挿入しません。

例外として、半角記号を使用するケース

英数字とあわせて表記する記号（例：通貨記号（¥）、単位記号（％））
数値の3桁ごとに使用するカンマ（,）
階層構造を表す際の区切り符（/，>）
変数を表す波括弧（{ }）
操作手順の案内に使う区切り符（>）

議事録

括弧類は「」、［］、【】、（）を使用する

説明

文章における強調は鉤括弧「」もしくは隅付き括弧【】を使用し、引用符“ ” や二重かぎ括弧 『』は使用しません。
補足は丸括弧（）を使用します。丸括弧に限り、全文英語のプレスリリースやWovnでの翻訳結果で半角( )を使用します。

括弧「」、［］、【】の使い分け

説明

アプリケーション上での括弧の使い分けは以下です。
ヘルプページやリリースノートも準じます。

鉤括弧`「」`

ファイル名を示すのに用います。
フォームなどにユーザーが入力する文字列や値を示すのに用います。
- 例：「1000」と入力します。
文や単語を強調したいときに用います。
- 例：スキル管理機能には、「機能管理者」、「業務担当者」の2種類の管理者権限があります。
地の文と区別したい文や単語に用います。
- 例：データを更新して、SmartHR基本機能と同じ状態にすることを「データを同期する」と言います。

角括弧`［］`

設定項目名、タブ名、操作ボタン名、選択肢などに用います。なお、画面名には［］をつけません。
- 例：パスワードを入力して［登録する］を押します。
- 例：マイナンバー管理画面に移動します。

隅付き括弧`【】`

ユーザーが独自に命名するオブジェクト名に用います。
- 例：【2023年上期評価】を削除します。

議事録

https://kufuinc.slack.com/archives/CJX59GJFR/p1695364655322429

三点リーダー（…）は1つでOK

説明

紙の場合、「…」を使用する場合は、2つで1セットとするのが通例とされていますが、ウェブなのであまり気にせず1つに統一とします。

変数は{ }を使用する

説明

環境や設定によって値が変わる変数は、{ }を使用します。
記述記号は全角を使用しますが、例外として、{ }は半角を使用します。

例

{会社名}、{サブドメイン}.smarthr.jp

議事録

https://kufuinc.slack.com/archives/CJX59GJFR/p1664497034945159

例を示すときには、コロン（：）を使用する

説明

ヒントメッセージなどで、例を示すときには「（）」ではなく、「：」を使いましょう。

括弧類は、左右を組み合わせて（両括弧）の使用が基本的な用法。右側のみ（片括弧）で使うことも間違いではないものの、学術論文や大学のレポートなどでの使用なので、SmartHRのヒントメッセージなどでは、両括弧を推奨とします。

また、例：と（例）で比較すると、コロンを使用した方が少ない文字数に収められるので、「：」を使うことにしました。

例

OK：例：hogehoge
NG：（例）hogehoge、例）hogehoge、例: hogehoge