yoshimana yoshimana

name

japanese-tech-writing

description

日本語の技術文書・書籍原稿の文章規範。整形（一文一行、引用ブロック、脚注、コラム記法）、段落と論証の構成（パラグラフライティング）、論証の厳密さ（ツッコミどころの除去）、読み手の負荷の管理、視点と語り、演出の抑制、LLM っぽい空句の禁止、冗長の排除を定める。日本語で技術書の章、草稿、記事、解説文を書くとき、または推敲・リライトするときに使用する。

日本語技術文書の文章規範

日本語で技術的な原稿（書籍の章、記事、解説文）を書く・推敲するときは、以下の規範に従う。

整形

name

cognitive-rhythm-writing

description

説明的な文章に緩急を設計するための規範。緩急を装飾ではなく認知モードの切替（観察→逡巡→断定→再観察）と未回収の緊張の管理として扱い、文の拍、段落の密度波形、節の入り方、緩みと駄文の判別、執筆後の機械的な点検手順を定める。読み物として読ませたい章・記事・解説文を生成するとき、または「密度はあるが平坦でおもしろくない」文章を診断・修正するときに使用する。

認知リズムを生むための日本語ライティング規範

密度の高い文章が退屈になるのは、情報が多いからではなく、全文が同じ認知モードで書かれているからである。この規範は、読者の認知モード（観察する、迷う、確信する、確かめ直す）を意図的に切り替え、常に「続きを読む理由」を維持することで、読み進める推進力を作る。

	【読み物ライティング規範】解説記事・章・エッセイ・ブログ等「読ませる文章」の執筆・推敲時に適用。通常のQ&Aや事務文書には適用しない。

	■原理
	・緩急は情報量の増減でなく認知モード（観察→逡巡→断定→再観察）の切替で作る。
	・常に未回収の緊張（未回答の問い、後で崩される確信）を最低1つ開いておく。
	・完成した結論を解説する声でなく、考えながら進む当事者の声で書く。
	・拍や緊張の材料は対象世界（出来事・データ・発言・語り手の判断状態）からのみ取る。材料がない箇所は無理に足さず平坦のまま残す。

	■文と段落
	・「短文で立てる→長文で流す→短文で止める」を段落の基本拍とする。断定と逡巡（後で事実に裏切られる確信を含む）を交互に置く。長い断定文を3つ以上連続させない。