Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
書く技術
Search
Fukazawa Shun
April 20, 2022
Technology
0
2.2k
書く技術
Fukazawa Shun
April 20, 2022
Tweet
Share
More Decks by Fukazawa Shun
See All by Fukazawa Shun
AIをプライベートや業務で使ってみよう!効果的な認定資格の活かし方
fukazawashun
0
98
試験は暗記より理解 〜効果的な試験勉強とその後への活かし方〜
fukazawashun
0
500
AWS認定資格取得に向けた効果的なデベキャン活用法や学習方法について
fukazawashun
1
320
DevelopersIO BASECAMP(デベキャン)の今までとこれからについて
fukazawashun
0
360k
DevelopersIO BASECAMPで扱うサービスのアップデート紹介
fukazawashun
0
920
GitHub Actionsを使ってAWS App Runnerにデプロイできるようになりました
fukazawashun
0
1.6k
TerraformとCloudFormationどちらを採用すべき?
fukazawashun
0
19k
Other Decks in Technology
See All in Technology
Function Body Macros で、SwiftUI の View に Accessibility Identifier を自動付与する/Function Body Macros: Autogenerate accessibility identifiers for SwiftUI Views
miichan
2
170
S3アクセス制御の設計ポイント
tommy0124
2
130
テストを軸にした生き残り術
kworkdev
PRO
0
190
バイブスに「型」を!Kent Beckに学ぶ、AI時代のテスト駆動開発
amixedcolor
2
440
データアナリストからアナリティクスエンジニアになった話
hiyokko_data
2
430
ChatGPTとPlantUML/Mermaidによるソフトウェア設計
gowhich501
1
120
大「個人開発サービス」時代に僕たちはどう生きるか
sotarok
20
9.5k
250905 大吉祥寺.pm 2025 前夜祭 「プログラミングに出会って20年、『今』が1番楽しい」
msykd
PRO
1
580
未経験者・初心者に贈る!40分でわかるAndroidアプリ開発の今と大事なポイント
operando
2
190
DDD集約とサービスコンテキスト境界との関係性
pandayumi
2
270
RSCの時代にReactとフレームワークの境界を探る
uhyo
10
3.2k
Skrub: machine-learning with dataframes
gaelvaroquaux
0
120
Featured
See All Featured
CoffeeScript is Beautiful & I Never Want to Write Plain JavaScript Again
sstephenson
162
15k
Into the Great Unknown - MozCon
thekraken
40
2k
Bootstrapping a Software Product
garrettdimon
PRO
307
110k
YesSQL, Process and Tooling at Scale
rocio
173
14k
The Invisible Side of Design
smashingmag
301
51k
Stop Working from a Prison Cell
hatefulcrawdad
271
21k
"I'm Feeling Lucky" - Building Great Search Experiences for Today's Users (#IAC19)
danielanewman
229
22k
Writing Fast Ruby
sferik
628
62k
Unsuck your backbone
ammeep
671
58k
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
irinanazarova
8
910
Done Done
chrislema
185
16k
Building Better People: How to give real-time feedback that sticks.
wjessup
368
19k
Transcript
1 プロフィール 深澤 俊(Fukazawa Shun) AWS 事業本部 コンサルティング部
2 ここまで本当に多くの⽅の⽀えが あり5冊も執筆の機会をいただく ことができました。
3 今⽇はそんな執筆活動を通して 培った「書く技術」をLTします。
4 技術1「ストーリーを意識する」 ストーリーを意識する
5 技術1「ストーリーを意識する」 • 執筆を始めるときはストーリーの組み⽴てから考えた⽅が吉 • 書きながら考えると全体が⾒えにくくなる 例︓「AWSの知識地図 2章」 CLIについて説明する 最後に構成図を⾒て⾃⾝の成⻑を実感してもらう
実際に順番に構築して操作する →超えられそうなハードルを⼩出しにする 基本的なwebサービスの構成を説明する やり遂げた結果のゴールを⾒てもらう →理解が難しいはずの構成図をあえて紹介 最初に⾻格を整えて、⾁ 付けしていくイメージ
6 技術2「なるべく幅広く触れる」 なるべく幅広く触れる
7 技術2「なるべく幅広く触れる」 • テーマは限られている • 例︓DynamoDBについて書く、CLIでのハンズオンをする • テーマだけを淡々と書くと少し淡⽩な仕上がりになる印象 例︓「AWSの知識地図 2章」
VPCを構築する CIDR表記の説明を⼊れる RFCを紹介する サブネットを構築する VPC内でいくつサブネットを 作るかという話にも触れる IPアドレスの説明を⼊れる ルーティング設定 読者になるべく多くのものを紹介することを意識 余談のようなものはコラムとして扱ったり、説明 しきれないものは詳しく書かれているブログのリ ンク先を紹介する
8 技術3「他の章との連携を意識する」 他の章との連携を意識する
9 技術3「他の章との連携を意識する」 • ⾃分の章だけで⼿いっぱいになってしまいがち • 読者から⾒たら1冊の成果物となることを意識 • 執筆メンバーでコミュニケーションをとっていこう︕ 例︓「AWSの知識地図」 AWSの全体像を押さえる
AWSでWeb環境を構築する 安全にAWSを使うための基礎知識を押さえる 現場でAWSを使いこなすサービスを押さえる 2章ではどうしてもAWSそのもの の知識やIT基礎のような部分の 知識が前提になる → 1章で必要な知識を解説 2章ではハンズオンメインのため セキュリティの説明が難しい → 3章で2章の実例を紹介しなが ら改善を紹介 Web周りのサービスばかりの紹 介でAWS全体の魅⼒を紹介しき れてない → 4章で幅広いサービスを紹介 しまさに本のタイトルを表現す るような締めに
10 技術4「毎⽇書く」 毎⽇書く
11 技術4「毎⽇書く」 • 執筆では⽂章量は最低でも1万字を越える • ちなみに「AWSの知識地図」の2章は約12万字 • 書くのは体⼒がいる(本当に疲れます) • まとめて書くとストーリがブレる
• 執筆が決まった⽇から1⽇1000⽂字は書くことを推奨 • 順番は気にしない • 書きたいことを書いてブロックとしてまとめる • 最後にストーリーに従ってまとめていく 例︓「AWSの知識地図 2章」 EC2構築のハンズオン AutoScalingGroup構築 のハンズオン RDS構築のハンズオン ELB構築のハンズオン SystemManagerを使⽤ したEC2へのログイン EIPの解説や設定
12 最後に、 今まで僕と執筆を⼀緒にやってくれたメンバー、 このような活動を応援してくれる クラスメソッドに⼼から感謝します︕︕
13