開発者のためのテクニカルライティング十戒
(tech-kakaoenterprise.tistory.com)-
必須の文の構成要素を省略しない
-
文の構成要素の対応関係を保つ
-
助詞を正しく使う
-
受け身形・使役形を避ける
-
二重否定を避ける
-
明確な表現を使う
-
順序と一覧を区別する
-
箇条書きを活用する
-
正書法・分かち書きをチェックする
-
外来語表記をチェックする
必須の文の構成要素を省略しない
文の構成要素の対応関係を保つ
助詞を正しく使う
受け身形・使役形を避ける
二重否定を避ける
明確な表現を使う
順序と一覧を区別する
箇条書きを活用する
正書法・分かち書きをチェックする
外来語表記をチェックする
2件のコメント
テクニカルライティングの4大原則 https://ja.news.hada.io/topic?id=5409
推敲の技術 - 開発者の技術文書作成法 https://ja.news.hada.io/topic?id=5446
プログラマーの場合、外来語表記法は事実上英語だけ気にすればよいのですが、韓国語の外来語表記法はつづりではなく実際の発音を基準にする点、そして英語はつづりが発音を正確に反映していないため、単語のスペルではなく発音記号を見て移すという点を念頭に置くと、ミスが少なくなります。
よく分からなければ、1) 国語辞典でその英単語をそのまま引いて載っていればそれを使い、2) 載っていなければ英語辞典でその単語を調べて国際音声記号(IPA)を見て表記を推測すればよいです。ただし、外来語表記法の規定は英語についてはイギリス式発音を手本にしているため、意外な表記になることも少なくありません。
英語でなければ、ハングライズ(https://hangulize.org/)のようなものを使うと便利ですが…