Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Sign up for free
Menu
Search
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Pricing
Search
Sign in
Sign up for free
日本語へのこだわりのススメ
Search
Sponsored
·
Your Podcast. Everywhere. Effortlessly.
Share. Educate. Inspire. Entertain. You do you. We'll handle the rest.
→
KNOWLEDGE WORK / 株式会社ナレッジワーク
PRO
May 14, 2026
Technology
440
0
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
日本語へのこだわりのススメ
ナレッジワークの社内技術共有会 Encraft Share Day(ESD)での発表資料です
@iinon(QAエンジニア)
KNOWLEDGE WORK / 株式会社ナレッジワーク
PRO
May 14, 2026
Transcript
21 slides
日本語へのこだわりのススメ @iinon
© Knowledge Work Inc. はじめに 2 • 今日話す内容は、『分かりやすい、読みやすい文章の書き方』 ・・・ではありません! •
普段 がテスト設計をしているときなどに気にしていることのご紹介 です ◦ 設計ドキュメント(minispecやDesignDoc)を読むとき ◦ 設計ドキュメント(TestDesignDoc)を書くとき
© Knowledge Work Inc. なぜ日本語にこだわるのか? 3 • 誤解や勘違いはバグの種になる ◦ 特にminispecやDesignDocで誤解や勘違いが生じると、
のちのち面倒なバグになる可能性が高い • 日本語にこだわると、 誤解や勘違いを防げる!あるいは、 気付くキッカケを得られる! ・・・かもしれない
© Knowledge Work Inc. こだわり その1 4 『主体』、『対象・データ』、『機能』の表現 に、こだわる
© Knowledge Work Inc. こだわり その1 5 『主体』、『対象・データ』、『機能』の表現 に、こだわる 誰が
何を どうする
© Knowledge Work Inc. こだわり その1 6 • 『主体』(誰が)を意識して、能動態 と
受動態 を書き分ける ◦ 例えば、 ▪ 必須項目が未入力の状態で 「保存」ボタンを押したら、アラートを表示する と、なりがちなところを ▪ 必須項目が未入力の状態で 「保存」ボタンが押されたら、アラートを表示する ▪ 必須項目が未入力の状態で 「保存」ボタンを押したら、アラートが表示される と、する
© Knowledge Work Inc. こだわり その1 7 • 『主体』(誰が)を意識して、能動態 と
受動態 を書き分ける ◦ 例えば、 ▪ 必須項目が未入力の状態で 「更新」ボタンを押したら、アラートを表示する と、なりがちなところを ▪ 必須項目が未入力の状態で 「更新」ボタンが押されたら、アラートを表示する ▪ 必須項目が未入力の状態で 「更新」ボタンを押したら、アラートが表示される と、する ユーザーが主体 システムが主体 主体を システムで統一 主体を ユーザーで統一
© Knowledge Work Inc. こだわり その1 8 • 『対象・データ』(何を)は 名詞
で、 『機能』(どうする)は 動詞 で書く ◦ 例えば、「更新」ボタンがクリックされたときの機能として、 ▪ 入力値の保存を行い、トーストで完了メッセージを表示 と、なりがちなところを ▪ 入力値を保存したら、トーストで完了メッセージを表示する と、する
© Knowledge Work Inc. こだわり その1 9 • 『対象・データ』(何を)は 名詞
で、 『機能』(どうする)は 動詞 で書く ◦ 例えば、「更新」ボタンがクリックされたときの機能として、 ▪ 入力値の保存を行い、トーストで完了メッセージを表示 と、なりがちなところを ▪ 入力値を保存したら、トーストで完了メッセージを表示する と、する 『機能』が明確になる 他のケースを意識しやすくなる
© Knowledge Work Inc. こだわり その1 10 • 『対象・データ』(何を)は、 どこの(どこから)・どこへ
を レベルを揃えて 書く ◦ 例えば、 ▪ 最新の商談情報を表示する と、なりがちなところを ▪ {連携するSFAの製品名} から取得した最新の商談情報を、 {開発するプロダクトの名前} の商談情報パネルに表示する と、する
© Knowledge Work Inc. こだわり その1 11 • 『対象・データ』(何を)は、 どこの(どこから)・どこへ
を レベルを揃えて 書く ◦ 例えば、 ▪ 最新の商談情報を表示する と、なりがちなところを ▪ {連携するSFAの製品名} から取得した最新の商談情報を、 {開発するプロダクトの名前} の商談情報パネルに表示する と、する 『対象・データ』の所在が明確になる 「どこから、どこへ」「何を、どこへ」が明確になる
© Knowledge Work Inc. こだわり その2 12 表現のバリエーション に、こだわる
© Knowledge Work Inc. こだわり その2 13 同じ対象に同じ表現(ワード)を使うのは、大事 ただ、 複数の条件を指定するときは、同じ表現を繰り返さないことが、大事
だと、 は思っている
© Knowledge Work Inc. こだわり その2 14 • 同じ表現の繰り返し、 ◦
~の場合、~の場合、 ◦ ~のとき、~のとき、 は、ないとしても、 ◦ ~の場合に、~の場合は、 ◦ ~のときで、~のときは、 となると、意外とやりがち • ではなく、 ◦ ~の場合 ◦ ~のとき ◦ ~であれば のように、違う表現を使う • それぞれの表現で 対象とする条件のレベルを揃える +
© Knowledge Work Inc. こだわり その2 15 • 例えば、 ◦
[曜日に関する条件] の場合、[時間に関する条件A] のときは、***する ◦ [時間に関する条件B] の場合、[人数に関する条件] のときは、***する と、なりがちなところを ◦ [曜日に関する条件] の場合、 ▪ [時間に関する条件A] のときは、***する ▪ [時間に関する条件B] のときは、[人数に関する条件] であれば、***する のようにする
© Knowledge Work Inc. こだわり その2 16 • 例えば、 ◦
[曜日に関する条件] の場合、[時間に関する条件A] のときは、***する ◦ [時間に関する条件B] の場合、[人数に関する条件] のときは、***する と、なりがちなところを ◦ [曜日に関する条件] の場合、 ▪ [時間に関する条件A] のときは、***する ▪ [時間に関する条件B] のときは、[人数に関する条件] であれば、***する のようにする
© Knowledge Work Inc. こだわり その3 17 他に解釈の余地がない表現 に、こだわる
© Knowledge Work Inc. こだわり その3 18 • 「~も」とか「それ以外は~」などは要注意 ◦
「~も」に含まれる範囲は、他に解釈の余地はない? ◦ 「それ以外」は、本当に一括りにしてよい? • MECE(モレなく、ダブりなく)という言葉があるが、 文章で表現する場合は、あえてダブらせて対比や差分を強調 する
© Knowledge Work Inc. こだわり その3 19 • 例えば、 ◦
希望日が平日の午前中であれば、予約が必要 ◦ 週末も同様 のような書き方がされている場合、 ◦ 希望日が平日の午前中であれば、予約が必要 ◦ 希望日が土曜日・日曜日であれば、終日、予約が必要 のようにする さらに、 ◦ 希望日が平日の場合は、午前中、予約が必要になる ◦ 希望日が土曜日・日曜日の場合は、終日、予約が必要になる のようになっていると、なお良し
© Knowledge Work Inc. まとめ 20 • 今回は、 が日頃意識している日本語へのこだわりをご紹介しました •
実際の成果物では、読みやすさを重視して 今まで話してきたような表現にしていない場合も多いです が、 • 一度は脳内に思い浮かべてみたり、実際にテキストにしてみたりして、 ◦ バグの種になりそうなものがないか? ◦ 他に考えや解釈を広げられる余地はないか? を確認するようにしています
None
More Decks by KNOWLEDGE WORK / 株式会社ナレッジワーク
See All by KNOWLEDGE WORK / 株式会社ナレッジワーク
Context parameters で作る!はじめての型クラス
kworkdev
PRO
1
160
FinOpsを導入してマルチプロダクトのコスト最適化を実現する
kworkdev
PRO
0
170
なぜAI時代に技術記事を書くのか?どう書くのか? 〜bunの場合〜
kworkdev
PRO
0
5k
AIカンパニーへの転換を支えた、エンジニアの仕事の再定義
kworkdev
PRO
2
2.2k
営業オントロジーの作り方と、エージェントからの辿り方 ── ナレッジワークの現場から
kworkdev
PRO
1
600
その nil、本当にありえませんか ? Go に制約を書く静的解析
kworkdev
PRO
0
100
QAロールのスキルアセスメントを作って終わりにしないための運用実践
kworkdev
PRO
0
500
モノレポのRenovateトイルをAIで改善していった話
kworkdev
PRO
1
130
AIチャット検索改善の3週間
kworkdev
PRO
2
320
Other Decks in Technology
See All in Technology
サーバーラックは作る時代! 3Dプリンターで作る10インチラックのススメ
jacopen
2
490
おうち環境でも「なるべく止めたくない!」 ― おうち環境の機器冗長化の理想と現実
yuutosi
1
610
DevOps Agentにあらゆるセキュリティインシデントのトリアージを任せた件
jirtosterone
1
190
gradle-best-practices 使ってみた
mikanichinose
0
190
Amazon Bedrock AgentCore の基礎とセキュリティ・ガバナンス
ren8k
0
210
HTTP通信に使おうとすると実はめんどくさいfile_get_contents
maguroalternative
0
230
「個社」ではなく「業界」の課題を解く AI 対話開発 ー 価値を広げる設計と、価値を守るエンジニアリング ー
ivry_presentationmaterials
3
790
常時稼働エージェントの作り方(Claude公式ブログを資料化)
minorun365
PRO
17
28k
AI×アジャイルで、石橋を高速で叩きながら渡る~電力会社がゼロから築いた会員サイト改善プロセス~ / 20261112 Ayami Kanazawa & Shigeru Hirai
shift_evolve
PRO
1
100
認知負荷の減らし方 ~開発にも日常業務にも活かせるノウハウ~
minorun365
PRO
10
8.2k
AWS Emulator を評価する: 手元で動く AWS の API の仕組み、始め方、確かめ方
inariku
PRO
2
780
エンタープライズIAMについて - ID・権限をどう統制するか
oidfj
1
250
Featured
See All Featured
jQuery: Nuts, Bolts and Bling
dougneiner
66
8.7k
What's in a price? How to price your products and services
michaelherold
247
13k
Jess Joyce - The Pitfalls of Following Frameworks
techseoconnect
PRO
1
480
Paper Plane
katiecoart
PRO
6
55k
WCS-LA-2024
lcolladotor
0
1k
We Have a Design System, Now What?
morganepeng
55
8.4k
Six Lessons from altMBA
skipperchong
29
4.6k
How To Stay Up To Date on Web Technology
chriscoyier
790
250k
Jamie Indigo - Trashchat’s Guide to Black Boxes: Technical SEO Tactics for LLMs
techseoconnect
PRO
0
760
The Illustrated Children's Guide to Kubernetes
chrisshort
51
53k
The State of eCommerce SEO: How to Win in Today's Products SERPs - #SEOweek
aleyda
2
12k
From π to Pie charts
rasagy
1
450