先輩ライターに訊く、技術文書執筆のアレコレ 先輩ライターに訊く、技術文書執筆のアレコレ(1)~花井志生(宇野るいも)さん 技術文書執筆の現場(1) 花井 志生(ペンネーム 宇野るいも)[著] 2011/09/26 14:00 コラム ポスト 目次 Page 1 1 はじめに 1.1 企画の背景 1.2 この連載で提供したいこと Page 2 2 執筆者紹介(共通の質問項目) 2.1 筆者プロフィール 2.2 代表的な執筆の成果物を教えてください 2.3 そのような執筆活動を行うようになった切っ掛けを教えてください 2.4 執筆活動のモチベーション(or やってよかったこと)は何ですか? 2.5 個人的に理想としている筆者、文章などはありますか? 2.6 執筆における失敗談、ブレイクスルーなどがあれば教えてください Page 3 3 技術解説文書の種類 3.1 テーマの選択 3.2 BCGマトリクス 3.3 合わせ技 3.4 紹介系文書を執筆する 3.5 know-how系文書を執筆する 3.6 その道の専門家が良い解説文書を書けるわけではない Page 4 4 執筆作業の実際 4.1 開発プロジェクトと比べると 4.2 執筆の実際 4.3 スケジュールを守るために 4.4 自分の売り込み 5 最後に 会員登録無料すると、続きをお読みいただけます 新規会員登録無料のご案内 ・全ての過去記事が閲覧できます ・会員限定メルマガを受信できます メールバックナンバー 新規会員登録無料 ログイン Page 1 1 はじめに 1.1 企画の背景 1.2 この連載で提供したいこと Page 2 2 執筆者紹介(共通の質問項目) 2.1 筆者プロフィール 2.2 代表的な執筆の成果物を教えてください 2.3 そのような執筆活動を行うようになった切っ掛けを教えてください 2.4 執筆活動のモチベーション(or やってよかったこと)は何ですか? 2.5 個人的に理想としている筆者、文章などはありますか? 2.6 執筆における失敗談、ブレイクスルーなどがあれば教えてください Page 3 3 技術解説文書の種類 3.1 テーマの選択 3.2 BCGマトリクス 3.3 合わせ技 3.4 紹介系文書を執筆する 3.5 know-how系文書を執筆する 3.6 その道の専門家が良い解説文書を書けるわけではない Page 4 4 執筆作業の実際 4.1 開発プロジェクトと比べると 4.2 執筆の実際 4.3 スケジュールを守るために 4.4 自分の売り込み 5 最後に 1 2 3 4 PREV この記事は参考になりましたか? 0参考になった 印刷用を表示 ポスト 先輩ライターに訊く、技術文書執筆のアレコレ連載記事一覧 先輩ライターに訊く、技術文書執筆のアレコレ(3) ~初心者向けの技術文書/合田英二さん 先輩ライターに訊く、技術文書執筆のアレコレ(2) ~チーム執筆/須江信洋さん 先輩ライターに訊く、技術文書執筆のアレコレ(1) ~花井志生(宇野るいも)さん もっと読む この記事の著者 花井 志生(ペンネーム 宇野るいも)(ハナイ シセイ(ペンネーム ウノルイモ)) ※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です この著者の最近の執筆記事 この記事は参考になりましたか? 0 参考になった この記事をシェア ポスト シェア CodeZine(コードジン) codezine.jp https://codezine.jp/static/common/images/czlogo4fb_ogp.png https://codezine.jp/article/detail/6165 2011/09/26 14:00 Special Contents AD キャリアインタビュー AD おすすめ アクセスランキング 1 エンジニアからプロダクトマネージャーへ ──コンフォートゾーンを抜け出して得られたキャリアの解像度を高める方法 2 技術力だけじゃダメなのか? ──多彩なキャリアを歩むKOBA789氏が語るエンジニアの未来戦略 NEW 3 無料模擬試験サイト「PRIME STUDY」、Python試験とPHP試験の模擬試験の受験回数が累計20万人突破 NEW 4 【実践的ユニットテスト入門】今からでも遅くない! ソフトウェアの最小単位を自動でテストする 5 DMM TV、大手国内配信事業者としてははじめて、次世代動画圧縮コーデック技術「AV1」を採用 NEW 6 メシウス、帳票開発用JavaScriptライブラリ「ActiveReportsJS V5J」をリリース 7 ソフトウェアのアーキテクチャを専門職目線で基礎から解説、『アーキテクトの教科書』発売 8 「サードパーティークッキー」 ~マンガでプログラミング用語解説 9 「Svelte」の活用に不可欠──プロジェクト構成とコンポーネント利用法を解説! NEW 10 モビリティ業界でのソフトウェア領域の重要性とは?──LLM活用で切り開く「完全自動運転」の現在 アクセスランキング 今日 月間 1 エンジニアからプロダクトマネージャーへ ──コンフォートゾーンを抜け出して得られたキャリアの解像度を高める方法 2 技術力だけじゃダメなのか? ──多彩なキャリアを歩むKOBA789氏が語るエンジニアの未来戦略 NEW 3 無料模擬試験サイト「PRIME STUDY」、Python試験とPHP試験の模擬試験の受験回数が累計20万人突破 NEW 4 【実践的ユニットテスト入門】今からでも遅くない! ソフトウェアの最小単位を自動でテストする 5 DMM TV、大手国内配信事業者としてははじめて、次世代動画圧縮コーデック技術「AV1」を採用 NEW 6 メシウス、帳票開発用JavaScriptライブラリ「ActiveReportsJS V5J」をリリース 7 ソフトウェアのアーキテクチャを専門職目線で基礎から解説、『アーキテクトの教科書』発売 8 「サードパーティークッキー」 ~マンガでプログラミング用語解説 9 「Svelte」の活用に不可欠──プロジェクト構成とコンポーネント利用法を解説! NEW 10 モビリティ業界でのソフトウェア領域の重要性とは?──LLM活用で切り開く「完全自動運転」の現在 1 "代替"されないエンジニアになるために──生成AI時代に求められるスキルポートフォリオとは 2 ChatGPTが普及した未来、プログラマーに求められることとは? 生成AIの普及と落とし穴 3 Pythonの爆速化! ピュアPythonに組み込まれている機能でコードの最適化を実現するには 4 小学6年生の「将来就きたい職業」、「IT関係」がトップ3に 5 Modern C++のモダンな言語仕様はもっとある! C++ 14から最新版までまとめて紹介 6 【作って学ぶPython】クラスとスプライトを学んでメンテナンスしやすいコードを書こう! 7 なぜアジャイルの導入は難しいのか? アジャイルとウォーターフォールの目的の違いから考える 8 Webページ用UIフレームワーク「Svelte」とは? プレーンで軽量なJavaScript生成を体験しよう! 9 2024年7月に開催される注目のITエンジニア向けカンファレンス5選 10 ソフトウェアのアーキテクチャを専門職目線で基礎から解説、『アーキテクトの教科書』発売 イベント CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。 新規会員登録無料のご案内 ・全ての過去記事が閲覧できます ・会員限定メルマガを受信できます メールバックナンバー 新規会員登録無料 ログイン アクセスランキング 1 エンジニアからプロダクトマネージャーへ ──コンフォートゾーンを抜け出して得られたキャリアの解像度を高める方法 2 技術力だけじゃダメなのか? ──多彩なキャリアを歩むKOBA789氏が語るエンジニアの未来戦略 NEW 3 無料模擬試験サイト「PRIME STUDY」、Python試験とPHP試験の模擬試験の受験回数が累計20万人突破 NEW 4 【実践的ユニットテスト入門】今からでも遅くない! ソフトウェアの最小単位を自動でテストする 5 DMM TV、大手国内配信事業者としてははじめて、次世代動画圧縮コーデック技術「AV1」を採用 NEW 6 メシウス、帳票開発用JavaScriptライブラリ「ActiveReportsJS V5J」をリリース 7 ソフトウェアのアーキテクチャを専門職目線で基礎から解説、『アーキテクトの教科書』発売 8 「サードパーティークッキー」 ~マンガでプログラミング用語解説 9 「Svelte」の活用に不可欠──プロジェクト構成とコンポーネント利用法を解説! NEW 10 モビリティ業界でのソフトウェア領域の重要性とは?──LLM活用で切り開く「完全自動運転」の現在 アクセスランキング 今日 月間 1 エンジニアからプロダクトマネージャーへ ──コンフォートゾーンを抜け出して得られたキャリアの解像度を高める方法 2 技術力だけじゃダメなのか? ──多彩なキャリアを歩むKOBA789氏が語るエンジニアの未来戦略 NEW 3 無料模擬試験サイト「PRIME STUDY」、Python試験とPHP試験の模擬試験の受験回数が累計20万人突破 NEW 4 【実践的ユニットテスト入門】今からでも遅くない! ソフトウェアの最小単位を自動でテストする 5 DMM TV、大手国内配信事業者としてははじめて、次世代動画圧縮コーデック技術「AV1」を採用 NEW 6 メシウス、帳票開発用JavaScriptライブラリ「ActiveReportsJS V5J」をリリース 7 ソフトウェアのアーキテクチャを専門職目線で基礎から解説、『アーキテクトの教科書』発売 8 「サードパーティークッキー」 ~マンガでプログラミング用語解説 9 「Svelte」の活用に不可欠──プロジェクト構成とコンポーネント利用法を解説! NEW 10 モビリティ業界でのソフトウェア領域の重要性とは?──LLM活用で切り開く「完全自動運転」の現在 1 "代替"されないエンジニアになるために──生成AI時代に求められるスキルポートフォリオとは 2 ChatGPTが普及した未来、プログラマーに求められることとは? 生成AIの普及と落とし穴 3 Pythonの爆速化! ピュアPythonに組み込まれている機能でコードの最適化を実現するには 4 小学6年生の「将来就きたい職業」、「IT関係」がトップ3に 5 Modern C++のモダンな言語仕様はもっとある! C++ 14から最新版までまとめて紹介 6 【作って学ぶPython】クラスとスプライトを学んでメンテナンスしやすいコードを書こう! 7 なぜアジャイルの導入は難しいのか? アジャイルとウォーターフォールの目的の違いから考える 8 Webページ用UIフレームワーク「Svelte」とは? プレーンで軽量なJavaScript生成を体験しよう! 9 2024年7月に開催される注目のITエンジニア向けカンファレンス5選 10 ソフトウェアのアーキテクチャを専門職目線で基礎から解説、『アーキテクトの教科書』発売