業務システム設計・移行ガイド」が発売されます。先日、見本誌が届きました。ピンクベースの表紙だったのですが、最終的には水色になったようです。(フロンターレ初タイトルの翌月に水色の本を出せるなんて!)「技術書を書くこと」はエンジニアとしての夢のひとつだったので、見本誌を手にしたときは感慨深かったです。抑えておきたいAWSの基本から、業務で使えるアドバンストな内容まで、よりどりみどりな内容になっています。読んでいただき、ご感想を頂けると嬉しいです。単行本この商品を含むブログを見る同時に、この感動を味わうためにも?2冊目、3冊目と技術書を継続して出せるようになりたい!と強く思いました。技術書の執筆を通して感じたこと今後、技術書を書くために普段から心がけたいと思ったことを整理していきたいと思います。技術書を書きたいと思っている方と、次に繋げていきたい未来の私向けのメモとなります。反省点:技術書の執筆を通して感じたこと技術のインプット&アウトプットがまだまだ甘い執筆者陣の得意な分野でパートを割り振ったこともあり、基本的には既に知っている内容を文章にしています。それでも文章にすると、細かい仕様や考え方が曖昧だな、と感じるシーンが多かったです。執筆初期に、リーダーの佐々木さんから「30分で2,000文字で書けるはず!」と言われていたのですが、私は1時間で1,000文字も書けなかったと記憶しています。この原因として、AWSのドキュメントを読み直し、実環境で検証した上で文章にしていたことが挙げられます。実際の仕様・動きを確認することは重要なのですが、日頃のインプット&アウトプットの質を挙げていればもっと効率的に進められたと感じました。(AWSさんのアップデートが早すぎる!のもあると思いますがw素晴らしいです。)言語化することの難しさもうひとつペースが上がらなかった理由として、「読みやすい」&「技術書向けの」文章を書くことの難しさが挙げられます。)でも書きましたが、10くらいのポイントを抑えるだけで「読みやすい」&「技術書向けの」文章にすることができました。実は、この本を読んで(&佐々木さんの初回レビューをもらったあとに)、ほぼほぼ全部の文章を書き直しています(笑)次はそうならないようにしたいものです。継続して書くことの難しさ年明けから企画を始め、3~4月くらいから書き始めたのですが、なかなか上手く書くことができませんでした。個人コミットログを見ても分かるとおり、6-8月に集中していることが分かります。この3ヶ月間は、休みの前の日は23時〜4時まで執筆していたので月80時間程度、夏休みのある8月は100時間以上は執筆に時間をかけていたと思います。次は、バランスよく継続して書いていきたいです。7月頃からポモドーロ・テクニックを導入したのですがこれが非常に良かったです。有名な手法ではありますが、25分書いて、5分休んでを繰り返すというもので、私にはとても合っていました。仕事でも取り入れてます。1日1~2サイクルでいいので、毎日書くことを心がけたいと思いました。改善点:普段から心がけようと思ったこと日々、得た技術を言語化するこの執筆が、技術ブログを始めようと(再開しようと)思ったきっかけになりました。自分のインプット&アウトプットを言語化することで、「なんとなく分かったつもりでいた」部分が見つかり、「え?こんな曖昧な状況で世の中に晒していいの?恥ずかしくない?」という想いが、自分の腹落ちに繋がると感じました。「読みやすい」&「技術書向けの」文章を書く訓練にもなっているはずです。ブログに日頃まとめた内容を本にできる(オファーがくる?)と理想だと感じています。)にも書いたのですが、「技術の徹底的な腹落ち」を心がけようと思います。業務やプライベートの開発で使った技術について、理解が及ばない部分を少しでも削れるような過ごし方をしていきます。良い技術文章をたくさん読むはてブで読みやすい文章の方をフォローして読むようにしています。技術ブログについては、言い回しを真似たりできないかなーと思いながら読むと、非常に学びが多いです。物理層の話など難しい内容も分かりやすく書かれています。文章の書き方を参考にさせていただこうと思っています。(最近、読み直してるので、こちらもまとめていきたいと思います。難しい内容を楽しく&分かりやすく解説するという意味でためになる本です。業務システム設計・移行ガイド」で私の好きな章と、反省点・改善点が多々ありましたが、私以外の優秀な執筆陣のレビュー、技術にも文章にも明るい編集者の方のおかげで、とても良い内容にできたと思います。本当に感謝しています。最後に、宣伝も兼ねて、今回私が執筆させて頂いたパートで個人的に気に入っている章を紹介します。ついても簡単に説明しています。AWSを使うからには、APIで構築を自動化していくべきです。この章は、その触りとしてはもってこいだと思います。0を1にするのが大変だと思うので(私も最初はキツかったです。)、そのご支援ができるようにサンプルコードを多めに紹介しています。使う機会が(プライベートで)多いのですが、実はこの章を頻繁に参照していますwまとめ「技術書を書く」という同じ夢を持つエンジニアの方に少しでも役に立つ記事になると幸いです。当日着?、書店さんにも遅くとも週明けには並べていただけるかと思います。お手に取っていただければ嬉しいです。単行本この商品を含むブログを見る先日、この本を「どんな人に」「どのように」読んでいただきたいかについても記事にしてみました。こちらも合わせて読んでいただければと思います。恒例の年末ポストです。2019年はあっという間でした。振り返り&来年の抱負記事です。良い...2018-03-312018年1月〜3月ふりかえりとKPT2018年1月〜3月について振り返りです。はてなブログPro2児の父なITエンジニアです。好きなサッカーチームは川崎フロンターレです。その他、子育て、社会問題、シビックテック関連の記事についても書いていきたいと思います:)※各ポストは個人の意見であり、所属する組織の見解とは関係ありません。(1)月別アーカイブその他プライバシーポリシースターをつけました引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。