SHOEISHA iD

※旧SEメンバーシップ会員の方は、同じ登録情報(メールアドレス&パスワード)でログインいただけます

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

先輩ライターに訊く、技術文書執筆のアレコレ

先輩ライターに訊く、技術文書執筆のアレコレ(3)
~初心者向けの技術文書/合田英二さん

技術文書執筆の現場(3)

  • X ポスト
  • このエントリーをはてなブックマークに追加

 本連載では、書籍や雑誌といった商用ベースでの技術文書を執筆したことがあるライターの体験談をリレー形式で紹介します。普段、なかなか突っ込んで聞く機会の少ない生の声をお伝えしますので、今後技術文書を執筆してみたいと考えている方の参考になれば幸いです。第三回は、合田 英二(ごうだ えいじ)です。

  • X ポスト
  • このエントリーをはてなブックマークに追加

1. はじめに

 会社の同僚から新入社員向けのJavaの記事を書いてみないかという依頼があり、執筆することがありました。今回は初心者向けの技術文書を執筆することについての経験談を共有できればと思います。

※注意

 本記事は著者個人の考えおよび経験に基づいて記述したものであり、所属する会社や組織の意見を表すものではありません。

2. 執筆者紹介(共通の質問項目)

2.1. 筆者プロフィール

 合田 英二(ごうだ えいじ)。外資系大手IT企業で、大型SI案件のメンバーとしてプロジェクトに参画。現在では、SI案件の見積りツールの展開を担当している。

2.2. 代表的な執筆の成果物を教えてください

2.2.1. 記事

  • 日経SYSTEMS:教えて!実装 & テスト工程 [第1回]~[第5回]連載(2007年10月号~2008年2月号)
  • 日経ソフトウェア:これで納得!オブジェクト指向 Part3:RSSリーダーの作成と改良で学ぶ(2009年6月号)

2.3. そのような執筆活動を行うようになった切っ掛けを教えてください

 自分が社外の雑誌で記事を執筆するなんて想像もできませんでしたが、会社の先輩からの紹介がきっかけとなりました。最初に書いてみない?と聞かれたときに、勢いでやらせてくださいと言ったことがよかったかもしれません。

2.4. 執筆活動のモチベーション(or やってよかったこと)は何ですか?

  • 自分の経験が社外で共有され参照してもらえる
  • 社内の優秀な方々と知り合いになれる
  • 出版業界の仕組みを知ることができた

2.5. 個人的に理想としている筆者、文章などはありますか?

 個人的に理想としている筆者は特におりませんが、目標とする文章はあります。読む人にとって分かりやすい文章でありながら、有益となるような文章です。

2.6. 執筆における失敗談、ブレイクスルーなどがあれば教えてください

 執筆を経験することで、自分が伝えたいことが何かということをより明確に考えるようになりました。最初の雑誌の連載を書いたときのことです。

 編集者から「ここの文章は結局何が伝えたいのでしょうか。箇条書きにしてみてくれますか」と言われたことがあるのですが、そのとおりに箇条書きにすると、1ページくらいの量の文章の内容がほんの数行になりました。

 これ以来、伝えたいことは何かを考える場合、まず箇条書きで書いてみるようになりました。そうすることで執筆がスムーズに進められるようになりました。

次のページ
3. 初心者向けの技術文書を執筆する手順

この記事は参考になりましたか?

  • X ポスト
  • このエントリーをはてなブックマークに追加
先輩ライターに訊く、技術文書執筆のアレコレ連載記事一覧

もっと読む

この記事の著者

合田 英二(ゴウダ エイジ)

外資系大手IT企業にて、大型SI案件のメンバーとしてプロジェクトに参画。現在では、SI案件の見積りツールの展開を担当している。

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

この記事は参考になりましたか?

この記事をシェア

  • X ポスト
  • このエントリーをはてなブックマークに追加
CodeZine(コードジン)
https://codezine.jp/article/detail/6301 2011/12/13 14:00

おすすめ

アクセスランキング

アクセスランキング

イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

新規会員登録無料のご案内

  • ・全ての過去記事が閲覧できます
  • ・会員限定メルマガを受信できます

メールバックナンバー

アクセスランキング

アクセスランキング