メインコンテンツまでスキップ

はじめて執筆する方へ

執筆に興味を持ってくださりありがとうございます!ここでは執筆にあたって知っておくべきことを説明します。

本書のターゲットを意識してください

「はじめに」の「誰に向けて書かれた本か?」に記載されている読者をイメージして、その人にとってちょうどよいレベル感を想像して書いてください。

📄️ はじめに

TypeScript入門『サバイバルTypeScript』〜実務で使うなら最低限ここだけはおさえておきたいこと〜

まったくのプログラミング初心者はターゲットではないため、たとえば「変数とは」「関数とは」といった初級すぎるところは説明を割愛します。しかし、変数という概念は他のプログラミング言語で知っているが、JavaScriptの構文として変数宣言をどう書くかは知らない可能性があります。なので、プログラミング経験者をイメージしつつも、JavaScriptの知識は無いかもしれないプログラマーを想像してください。

文体・スタイルを周りに合わせてください

基本的な文体スタイルは次のページで定めています。

📄️ 文体・スタイル

みんなで執筆しても同じような文体になるようにするためのガイドラインです。

用語はできるだけ統一してください

用語の表記ゆれができるだけ起こらないよう注意してください。「サーバ」や「サーバー」、「インターフェイス」「インターフェース」など、できるだけ既存のものに統一してください。神経を尖らせず、意識できる範囲で構いません。後で誰かが見つけて修正できます。

英語の訳語は一定の決まりがあります:

📄️ 日英対訳表

本書では専門用語を翻訳するにあたって、次の訳語を採用します。

途中でも公開しましょう

書き途中でもプルリクエストして構いません。途中までの情報でも、情報ゼロよりは読者の役に立ちます。

執筆の流れ

具体的な執筆の流れは次のページをご覧ください。

📄️ 執筆の流れ

環境構築から執筆、公開までの流れと手順を説明します。
  • 質問する ─ 読んでも分からなかったこと、TypeScriptで分からないこと、お気軽にGitHubまで🙂
  • 問題を報告する ─ 文章やサンプルコードなどの誤植はお知らせください。