先輩ライターに訊く、技術文書執筆のアレコレ 先輩ライターに訊く、技術文書執筆のアレコレ(1)~花井志生(宇野るいも)さん 技術文書執筆の現場(1) 花井 志生(ペンネーム 宇野るいも)[著] 2011/09/26 14:00 コラム Tweet 目次 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参考になった 印刷用を表示 Tweet 先輩ライターに訊く、技術文書執筆のアレコレ連載記事一覧 先輩ライターに訊く、技術文書執筆のアレコレ(3) ~初心者向けの技術文書/合田英二さん 先輩ライターに訊く、技術文書執筆のアレコレ(2) ~チーム執筆/須江信洋さん 先輩ライターに訊く、技術文書執筆のアレコレ(1) ~花井志生(宇野るいも)さん もっと読む この記事の著者 花井 志生(ペンネーム 宇野るいも)(ハナイ シセイ(ペンネーム ウノルイモ)) ※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です この著者の最近の執筆記事 この記事は参考になりましたか? 0 参考になった この記事をシェア Tweet シェア 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 「Java21」で何ができる? 新機能とJava17以降の変更点を紹介 NEW 2 フルスタックのWebフレームワーク「Remix v2」がリリース 3 目視のコードレビューまかせにしない!静的解析ツール「Axivion Suite」で業界最高水準のソフトウェア品質を担保 4 完璧なはずのコードがエラーで動かない! 二分探索で効率的にデバッグする方法 5 TypeScriptのサポートが強化されたVue3.3の新機能とは?──PropsとEmitsに関する新機能を解説【前編】 6 システム開発の限界を広げる可能性と魅力を秘めた、「高機能コンポーネント」導入のススメ NEW 7 どうやってコード品質を測るのか? ソースコード品質の測定指標とその活用 NEW 8 GitHub、AIアシスタントから自然言語でコーディング支援を受けられる「GitHub Copilot Chat」をすべての個人ユーザーに提供開始 NEW 9 Webアプリケーション用Reactフレームワーク「Next.js 13.5」がリリース NEW 10 グレープシティ、帳票開発用JavaScriptライブラリ「ActiveReportsJS V4.1J」をリリース NEW アクセスランキング 今日 月間 1 「Java21」で何ができる? 新機能とJava17以降の変更点を紹介 NEW 2 フルスタックのWebフレームワーク「Remix v2」がリリース 3 目視のコードレビューまかせにしない!静的解析ツール「Axivion Suite」で業界最高水準のソフトウェア品質を担保 4 完璧なはずのコードがエラーで動かない! 二分探索で効率的にデバッグする方法 5 TypeScriptのサポートが強化されたVue3.3の新機能とは?──PropsとEmitsに関する新機能を解説【前編】 6 システム開発の限界を広げる可能性と魅力を秘めた、「高機能コンポーネント」導入のススメ NEW 7 どうやってコード品質を測るのか? ソースコード品質の測定指標とその活用 NEW 8 GitHub、AIアシスタントから自然言語でコーディング支援を受けられる「GitHub Copilot Chat」をすべての個人ユーザーに提供開始 NEW 9 Webアプリケーション用Reactフレームワーク「Next.js 13.5」がリリース NEW 10 グレープシティ、帳票開発用JavaScriptライブラリ「ActiveReportsJS V4.1J」をリリース NEW 1 VSCodeをプログラミングエディタとして強化しよう! 便利な設定や拡張機能を紹介 2 Python/C/C++向けライブラリ「StringZilla」が登場、SIMD命令を利用して文字列操作を高速化 3 個人開発を始めてみよう──個人開発の楽しさと大きなメリットは? 4 Microsoft、「Visual Studio for Mac」の提供を終了、最新版のサポートは2024年8月末まで 5 JavaScript/TypeScript開発のためのオールインワンキット「Bun 1.0」がリリース 6 「char」 ~マンガでプログラミング用語解説 7 東大松尾研発、ELYZAが商用利用可能な70億パラメータの日本語LLM「ELYZA-japanese-Llama-2-7b」を一般公開 8 テスト自動化成功の鍵「テスト自動化アーキテクチャ」、構築のポイントと考え方とは 9 Modular、Pythonのスーパーセットを目指すプログラミング言語「Mojo」のダウンロード提供を開始 10 Next.jsの新常識「App Router」を学ぼう! イベント CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。 新規会員登録無料のご案内 ・全ての過去記事が閲覧できます ・会員限定メルマガを受信できます メールバックナンバー 新規会員登録無料 ログイン アクセスランキング 1 「Java21」で何ができる? 新機能とJava17以降の変更点を紹介 NEW 2 フルスタックのWebフレームワーク「Remix v2」がリリース 3 目視のコードレビューまかせにしない!静的解析ツール「Axivion Suite」で業界最高水準のソフトウェア品質を担保 4 完璧なはずのコードがエラーで動かない! 二分探索で効率的にデバッグする方法 5 TypeScriptのサポートが強化されたVue3.3の新機能とは?──PropsとEmitsに関する新機能を解説【前編】 6 システム開発の限界を広げる可能性と魅力を秘めた、「高機能コンポーネント」導入のススメ NEW 7 どうやってコード品質を測るのか? ソースコード品質の測定指標とその活用 NEW 8 GitHub、AIアシスタントから自然言語でコーディング支援を受けられる「GitHub Copilot Chat」をすべての個人ユーザーに提供開始 NEW 9 Webアプリケーション用Reactフレームワーク「Next.js 13.5」がリリース NEW 10 グレープシティ、帳票開発用JavaScriptライブラリ「ActiveReportsJS V4.1J」をリリース NEW アクセスランキング 今日 月間 1 「Java21」で何ができる? 新機能とJava17以降の変更点を紹介 NEW 2 フルスタックのWebフレームワーク「Remix v2」がリリース 3 目視のコードレビューまかせにしない!静的解析ツール「Axivion Suite」で業界最高水準のソフトウェア品質を担保 4 完璧なはずのコードがエラーで動かない! 二分探索で効率的にデバッグする方法 5 TypeScriptのサポートが強化されたVue3.3の新機能とは?──PropsとEmitsに関する新機能を解説【前編】 6 システム開発の限界を広げる可能性と魅力を秘めた、「高機能コンポーネント」導入のススメ NEW 7 どうやってコード品質を測るのか? ソースコード品質の測定指標とその活用 NEW 8 GitHub、AIアシスタントから自然言語でコーディング支援を受けられる「GitHub Copilot Chat」をすべての個人ユーザーに提供開始 NEW 9 Webアプリケーション用Reactフレームワーク「Next.js 13.5」がリリース NEW 10 グレープシティ、帳票開発用JavaScriptライブラリ「ActiveReportsJS V4.1J」をリリース NEW 1 VSCodeをプログラミングエディタとして強化しよう! 便利な設定や拡張機能を紹介 2 Python/C/C++向けライブラリ「StringZilla」が登場、SIMD命令を利用して文字列操作を高速化 3 個人開発を始めてみよう──個人開発の楽しさと大きなメリットは? 4 Microsoft、「Visual Studio for Mac」の提供を終了、最新版のサポートは2024年8月末まで 5 JavaScript/TypeScript開発のためのオールインワンキット「Bun 1.0」がリリース 6 「char」 ~マンガでプログラミング用語解説 7 東大松尾研発、ELYZAが商用利用可能な70億パラメータの日本語LLM「ELYZA-japanese-Llama-2-7b」を一般公開 8 テスト自動化成功の鍵「テスト自動化アーキテクチャ」、構築のポイントと考え方とは 9 Modular、Pythonのスーパーセットを目指すプログラミング言語「Mojo」のダウンロード提供を開始 10 Next.jsの新常識「App Router」を学ぼう!