先輩ライターに訊く、技術文書執筆のアレコレ 先輩ライターに訊く、技術文書執筆のアレコレ(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 最後に 次のページ4 執筆作業の実際 1 2 3 4 PREV NEXT この記事は参考になりましたか? 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 PR キャリアインタビュー PR おすすめ アクセスランキング 1 Microsoft、プログラミング言語「TypeScript 5.0」を正式に公開、デコレーターが標準機能に NEW 2 「リフレクション」 ~マンガでプログラミング用語解説 NEW 3 AVILEN、Pythonで学べる「全人類がわかる機械学習講座」を3月16日から提供開始 4 ReactのWebサイトが一新、サンプル・コードと実行結果を並べて表示する「サンドボックス」を採用 NEW 5 新世代Vim「Neovim」を多機能IDEに変身させる「AstroNvim 3.0.3」が登場 6 「情報セキュリティマネジメント試験」「基本情報技術者試験」、CBT方式での年間を通した随時試験を3月15日から開始 7 開発の定番「VSCode」とは? インストールから使い方までを解説 8 Python向けオープンソース機械学習ライブラリ「PyTorch 2.0」が正式リリース 9 Webアプリ構築・展開のためのPythonフレームワーク「Pynecone 0.1.20」がリリース 10 「VSCode」での開発をよりスムーズに!基本的で役に立つ拡張機能を解説 アクセスランキング 今日 月間 1 Microsoft、プログラミング言語「TypeScript 5.0」を正式に公開、デコレーターが標準機能に NEW 2 「リフレクション」 ~マンガでプログラミング用語解説 NEW 3 AVILEN、Pythonで学べる「全人類がわかる機械学習講座」を3月16日から提供開始 4 ReactのWebサイトが一新、サンプル・コードと実行結果を並べて表示する「サンドボックス」を採用 NEW 5 新世代Vim「Neovim」を多機能IDEに変身させる「AstroNvim 3.0.3」が登場 6 「情報セキュリティマネジメント試験」「基本情報技術者試験」、CBT方式での年間を通した随時試験を3月15日から開始 7 開発の定番「VSCode」とは? インストールから使い方までを解説 8 Python向けオープンソース機械学習ライブラリ「PyTorch 2.0」が正式リリース 9 Webアプリ構築・展開のためのPythonフレームワーク「Pynecone 0.1.20」がリリース 10 「VSCode」での開発をよりスムーズに!基本的で役に立つ拡張機能を解説 1 Gitの内部構造をよく理解して、うまく使おう【基本の仕組みを解説】 2 開発の定番「VSCode」とは? インストールから使い方までを解説 3 現役ITエンジニアがITエンジニア志望者に身につけてほしいスキル、「コミュニケーション能力」と「ドキュメントを読み書きする力」が上位に 4 Python向けデータ分析ライブラリ「Pandas」のバージョン2.0が登場、処理性能を大幅に改善 5 インフラエンジニアの約4割、システム設計・構築と音楽との共通点を実感 6 新世代Vim「Neovim」を多機能IDEに変身させる「AstroNvim 3.0.3」が登場 7 Webアプリ構築・展開のためのPythonフレームワーク「Pynecone 0.1.20」がリリース 8 いきなり転職はリスク!? ITエンジニアのための「副業」を活用した新しいキャリアの拓き方 9 無償デスクトップ自動化ツール「Power Automate Desktop」でテキストの暗号化を自動化する 10 【Git入門解説】Gitの基本的な使い方をマスターしよう イベント CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。 新規会員登録無料のご案内 ・全ての過去記事が閲覧できます ・会員限定メルマガを受信できます メールバックナンバー 新規会員登録無料 ログイン アクセスランキング 1 Microsoft、プログラミング言語「TypeScript 5.0」を正式に公開、デコレーターが標準機能に NEW 2 「リフレクション」 ~マンガでプログラミング用語解説 NEW 3 AVILEN、Pythonで学べる「全人類がわかる機械学習講座」を3月16日から提供開始 4 ReactのWebサイトが一新、サンプル・コードと実行結果を並べて表示する「サンドボックス」を採用 NEW 5 新世代Vim「Neovim」を多機能IDEに変身させる「AstroNvim 3.0.3」が登場 6 「情報セキュリティマネジメント試験」「基本情報技術者試験」、CBT方式での年間を通した随時試験を3月15日から開始 7 開発の定番「VSCode」とは? インストールから使い方までを解説 8 Python向けオープンソース機械学習ライブラリ「PyTorch 2.0」が正式リリース 9 Webアプリ構築・展開のためのPythonフレームワーク「Pynecone 0.1.20」がリリース 10 「VSCode」での開発をよりスムーズに!基本的で役に立つ拡張機能を解説 アクセスランキング 今日 月間 1 Microsoft、プログラミング言語「TypeScript 5.0」を正式に公開、デコレーターが標準機能に NEW 2 「リフレクション」 ~マンガでプログラミング用語解説 NEW 3 AVILEN、Pythonで学べる「全人類がわかる機械学習講座」を3月16日から提供開始 4 ReactのWebサイトが一新、サンプル・コードと実行結果を並べて表示する「サンドボックス」を採用 NEW 5 新世代Vim「Neovim」を多機能IDEに変身させる「AstroNvim 3.0.3」が登場 6 「情報セキュリティマネジメント試験」「基本情報技術者試験」、CBT方式での年間を通した随時試験を3月15日から開始 7 開発の定番「VSCode」とは? インストールから使い方までを解説 8 Python向けオープンソース機械学習ライブラリ「PyTorch 2.0」が正式リリース 9 Webアプリ構築・展開のためのPythonフレームワーク「Pynecone 0.1.20」がリリース 10 「VSCode」での開発をよりスムーズに!基本的で役に立つ拡張機能を解説 1 Gitの内部構造をよく理解して、うまく使おう【基本の仕組みを解説】 2 開発の定番「VSCode」とは? インストールから使い方までを解説 3 現役ITエンジニアがITエンジニア志望者に身につけてほしいスキル、「コミュニケーション能力」と「ドキュメントを読み書きする力」が上位に 4 Python向けデータ分析ライブラリ「Pandas」のバージョン2.0が登場、処理性能を大幅に改善 5 インフラエンジニアの約4割、システム設計・構築と音楽との共通点を実感 6 新世代Vim「Neovim」を多機能IDEに変身させる「AstroNvim 3.0.3」が登場 7 Webアプリ構築・展開のためのPythonフレームワーク「Pynecone 0.1.20」がリリース 8 いきなり転職はリスク!? ITエンジニアのための「副業」を活用した新しいキャリアの拓き方 9 無償デスクトップ自動化ツール「Power Automate Desktop」でテキストの暗号化を自動化する 10 【Git入門解説】Gitの基本的な使い方をマスターしよう