build after PR merge, add contributors guide, list

Author: shibukawa

CONTRIBUTING.md

@@ -0,0 +1,8 @@
+# 貢献者向けガイド
+
+Typoなどを見つけた方はPull Requestで報告してくださると助かります。
+
+* 原稿のreSTだけ修正すればOKです。HTML/PDFのビルドまでは不要です。
+* contributors.rstにgithubのアカウント名を掲載させていただきます（不要な場合はお知らせ下さい）。
+
+内容への指摘で、修正の仕方がわからない場合はissueとして報告をお願いします。

contributors.rst

@@ -0,0 +1,10 @@
+貢献者
+===========
+
+
+Pull Requestをくださった方々
+-----------------------------------
+
+* @called-d
+* @tkihira
+* @kaakaa

docs/.doctrees/async.doctree

@@ -108,7 +108,7 @@ JavaScriptでは時間のかかる処理を実行する場合、完了した後
 初めて見ると面食らうかもしれませんが、慣れてくるとコールバックよりも流れは追いやすいでしょう。
 
 この ``Promise`` がJavaScript標準の方法として決定されると、さらなる改善のために\ ``await``\ という新しいキーワードが導入されました。
-これは ``Promise`` を使ったコードの、 ``then()`` 節の中だけを並べたのとほぼ透過になります。
+これは ``Promise`` を使ったコードの、 ``then()`` 節の中だけを並べたのとほぼ等価になります。
 それにより、さらにフラットに書けるようになりましたし、行数も半分になります。
 内部的には、\ ``await``\ はまったく新しい機構というわけではなく、\ ``Promise``\ を扱いやすくする糖衣構文で、\ ``then()``\ を呼び出し、その引数で渡される値が関数の返り値となるように動作します。
 ``Promise`` 対応のコードを書くのと、 ``await`` 対応のコードを書くのは差がありません。
@@ -232,15 +232,15 @@ TypeScriptで提供されている ``if`` や ``for`` 、 ``while`` などは関
      return new 味噌汁();
    }
 
-   async function ご飯(): Promise<ご飯> {
+   async function ご飯温め(): Promise<ご飯> {
      await 電子レンジ();
      return new ご飯();
    }
 
-   const [a味噌汁, aご飯] = await Promise.all([味噌汁(), ご飯()]);
+   const [a味噌汁, aご飯] = await Promise.all([味噌汁温め(), ご飯温め()]);
    いただきます(a味噌汁, aご飯);
 
-``味噌汁()`` と ``ご飯()`` は ``async`` がついた関数です。
+``味噌汁温め()`` と ``ご飯温め()`` は ``async`` がついた関数です。
 省略可能ですがあえて返り値に ``Promise`` をつけています。
 これまでの例では、 ``async`` 関数を呼ぶ時には ``await`` をつけていました。
 ``await`` をつけると、待った後の結果（ここでは味噌汁とご飯のインスタンス）が帰ってきます。

docs/.doctrees/baseenv.doctree

@@ -111,7 +111,7 @@ srcフォルダ以下に.tsファイルを入れて、出力先のフォルダ
       eslint-config-prettier npm-run-all
 
 設定ファイルは以下のコマンドを起動すると雛形を作ってくれます。これを対象の成果物ごとに編集していきます。
-詳細は各パッケージの種類の賞で取り扱います。
+詳細は各パッケージの種類の章で取り扱います。
 
 .. code-block:: bash
 

docs/.doctrees/class.doctree

@@ -122,7 +122,7 @@ TypeScriptにはC++やJavaのような ``private`` と ``protected`` 、 ``publi
 ----------------------------------------------------
 
 TypeScript固有の書き方になりますが、コンストラクタ関数にアクセス制御の装飾子をつけると、それがそのままプロパティになります。
-コンストラクタの引数をそのまま同盟のプロパティに代入します。
+コンストラクタの引数をそのまま同名のプロパティに代入します。
 
 .. code-block:: ts
    :caption: プロパティ定義をコンストラクタ変数に
@@ -211,7 +211,7 @@ Javaと違って、すべての要素をクラスで包む必要はないため
    console.log(Point.polar(10, Math.PI * 0.25));
 
 静的なプロパティを使いすぎると、複製できないクラスになってしまい、テストなどがしにくくなります。
-あまり多様することはないでしょう。
+あまり多用することはないでしょう。
 
 インスタンスクラスフィールド
 ----------------------------------------------------
@@ -482,7 +482,7 @@ Javaとかでよく使われるユースケースは、 ``private`` でメンバ
 継承とかオブジェクト指向設計とか方法論とかメソッドはメッセージで云々とか語り出すと大抵炎上するのがオブジェクト指向とかクラスの説明の難しいところです。
 これらの機能は、言語の文化とか、他の代替文法の有無とかで使われ方が大きく変わってきます。
 
-TypeScript界隈では、Angularなどのフレームワークではインタフェースが多様されています。
+TypeScript界隈では、Angularなどのフレームワークではインタフェースが多用されています。
 ユーザーが実装するコンポーネントなどのクラスにおいて、Anguarが提供するサービスを受けるためのメソッドの形式が決まっていて、実装部分の中身をライブラリユーザーが実装するといった使われ方をしています。
 ``OnInit`` をimplementsすると、初期化時に呼び出されるといった具合です。
 
@@ -566,7 +566,7 @@ TypeScriptではtsconfig.jsonの\ ``compilerOptions.experimentalDecorators``\ 
 一般的なクラスの機能を備えた上で、型チェックも行われ、さらにデコレータなど追加機能なども含まれました。
 TypeScriptの場合は、エディタによるコード補完の正答率が大幅に上がったりしてリターンが大きいため、生産性の高まりを感じられるでしょう。
 
-いろいろと機能は多いですが、TypeScriptでは、あまりクラスの細かい機能を多様するコーディングは行われていません。
+いろいろと機能は多いですが、TypeScriptでは、あまりクラスの細かい機能を多用するコーディングは行われていません。
 そのため、本章で取り上げた機能のうち、使わない機能も多いはずです。
 ちょっとしたロジックが書ける（バリデーションなど）構造体、といった感じで使われることがほとんどでしょう。
 最重要なところをピックアップするとしたら次のあたりです。
@@ -589,7 +589,7 @@ TypeScriptの場合は、エディタによるコード補完の正答率が大
 
 次の機能をTypeScriptで駆使するようになったら警戒しましょう。
 まず、2段、3段、4段と続くような深い継承になるようなコードを書くことはないでしょう。
-``private`` はともかく継承を前提とする ``protected`` 、抽象クラスを多様するような複雑なクラス設計がでてきたら、アプリケーションコードレベルではほぼ間違いだと思います。
+``private`` はともかく継承を前提とする ``protected`` 、抽象クラスを多用するような複雑なクラス設計がでてきたら、アプリケーションコードレベルではほぼ間違いだと思います。
 もしかしたら、DOMに匹敵するような大規模なクラスライブラリを作るのであれば、抽象クラスだとか ``protected`` も活躍するかもしれませんが、ほぼ稀でしょう。
 せいぜいインタフェースを定義して、特定のメソッドを持っていたら仲間とみなす、ぐらいのダックタイピングとクラス指向の中間ぐらいがTypeScriptのスイートスポットだと思います。
 

docs/.doctrees/clienv.doctree

@@ -34,7 +34,7 @@ Node.jsの機能を使うことになるため、Node.jsのAPIの型定義ファ
       @types/source-map-support
 
 TypeScriptのビルド設定のポイントは、ブラウザからは使わないので、ターゲットのバージョンを高くできる点にあります。
-ローカルでは安定板を使ったとしてもNode.js 10が使えるでしょう。
+ローカルでは安定版を使ったとしてもNode.js 10が使えるでしょう。
 
 ライブラリのときとは異なり、成果物を利用するのはNode.jsの処理系だけなので、.d.tsファイルを生成する必要はありません。
 

docs/.doctrees/complex.doctree

@@ -7,7 +7,7 @@
 配列
 -----------------------------
 
-配列はTypeScriptの中でかなり多様されるリテラルですが、スプレッド構文、分割代入などが加わり、また、数々のメソッドを駆使することで、関数型言語のような書き方もできます。
+配列はTypeScriptの中でかなり多用されるリテラルですが、スプレッド構文、分割代入などが加わり、また、数々のメソッドを駆使することで、関数型言語のような書き方もできます。
 配列は、次に紹介するオブジェクトと同様、リテラルで定義できる複合型の1つです。
 
 .. code-block:: ts
@@ -137,7 +137,7 @@ C言語由来のループは昔からあるものですがループ変数が必
 ``forEach()``\ はその後ES5で追加されましたが、その後は言語仕様のアップデートとともに\ ``for ... of``\ 構文が追加されました。
 この構文は\ ``Array``\ , \ ``Set``\ , \ ``Map``\ 、\ ``String``\ などの繰り返し可能（iterable）オブジェクトに対してループします。
 配列の場合で、インデックス値が欲しい場合は、\ ``entries()``\ メソッドを使います。
-関数型主義的なスタイルで統一するために、\ ``for ... of``\  を禁止して\ ``forEach()``\ のみを使うというコーディング標準を規定している会社もあります（AirBnB）。
+関数型主義的なスタイルで統一するために、\ ``for ... of``\  を禁止して\ ``forEach()``\ のみを使うというコーディング標準を規定している会社もあります（Airbnb）。
 
 .. code-block:: ts
 
@@ -190,7 +190,7 @@ iterableとイテレータ
 この ``next()`` は、配列の要素と、終了したかどうかの boolean値を返します。
 イテレータ（厳密には外部イテレータと呼ばれる）はJavaやPython、C++ではおなじみのものです。
 
-上記の ``b`` のように全部の要素を持つ二重配列を作ってしまえばこのようなイテレータというものは必要ありませんが、その場合、要素数が多くなればなるほど、コピーに時間がかかってループが回る前の準備が遅くなる、という欠点を抱えることになります。そのため、このイテレータという要素を返すオブジェクトをつかい、全コピーを防いでいます。
+上記の ``b`` のように全部の要素を持つ二重配列を作ってしまえばこのようなイテレータというものは必要ありませんが、その場合、要素数が多くなればなるほど、コピーに時間がかかってループが回る前の準備が遅くなる、という欠点を抱えることになります。そのため、このイテレータという要素を返すオブジェクトを使い、全コピーを防いでいます。
 
 オブジェクにループの要素を取り出すメソッド（\ ``@@iterator``\ ）があるオブジェクトはiterableなオブジェクトです。
 繰り返し処理に対する約束事なので「iterableプロトコル」と呼ばれます。

docs/.doctrees/contributors.doctree

@@ -0,0 +1,10 @@
+貢献者
+===========
+
+
+Pull Requestをくださった方々
+-----------------------------------
+
+* @called-d
+* @tkihira
+* @kaakaa

docs/.doctrees/ecosystem.doctree

@@ -170,7 +170,7 @@ ts-nodeを気軽に試すREPL（1行ごとに実行されるインタプリタ
 TypeScriptの環境設定
 ------------------------
 
-TypeScriptを使うには、いくつか設定が必要です。JavaScript系のツールのビルどは大きく分けて、2つのフェーズがあります。
+TypeScriptを使うには、いくつか設定が必要です。JavaScript系のツールのビルドは大きく分けて、2つのフェーズがあります。
 
 * コンパイル: TypeScriptや最新のJavaScript文法で書かれたコードを、実行環境にあわせたJavaScriptに変換
 * バンドル: ソースコードは通常、整理しやすいクラスごと、コンポーネントごとといった単位で分けて記述します。配布時には1ファイルにまとめてダウンロードの高速化、無駄な使われてないコードの排除が行われます。

docs/.doctrees/environment.pickle

@@ -8,7 +8,7 @@
 
 JavaScriptでは、やっかいなのが\ ``this``\ です。無名関数をコールバック関数に渡そうとすると、\ ``this``\ がわからなくなってしまう問題があります。
 アロー関数を使うと、その関数が定義された場所の\ ``this``\ の保持までセットで行いますので、無名関数の\ ``this``\ 由来の問題をかなり軽減できます。
-表記も短いため、コードの幅も短くなり、コールバックを多様するところで ``function`` という長いキーワードが頻出するのを減らすことができます。
+表記も短いため、コードの幅も短くなり、コールバックを多用するところで ``function`` という長いキーワードが頻出するのを減らすことができます。
 
 .. code-block:: ts
    :caption: アロー関数

docs/.doctrees/function.doctree

@@ -10,6 +10,10 @@
 
    本ドキュメントは、まだ未完成ですが、ウェブフロントエンドの開発を学ぶときに、JavaScriptを経由せずに、最初からTypeScriptで学んでいく社内向けコンテンツとして作成されはじめました。基本の文法部分以外はまだ執筆されていない章もいくつもあります。書かれている章もまだまだ内容が追加される可能性がありますし、環境の変化で内容の変更が入る可能性もあります。
 
+   書籍の原稿はGitHub上で管理しております。もしTypoを見つけてくださった方がいらっしゃいましたら、 `GitHub上で連絡 <https://github.com/future-architect/typescript-guide/pulls>`_ をお願いします [#]_ 。reSTファイルだけ修正してもらえれば、HTML/PDFの生成までは不要です。フィードバックなども歓迎しております。
+
+   .. [#] https://github.com/future-architect/typescript-guide/pulls
+
 .. raw:: html
 
    <p><a href="./typescript-guide.pdf">PDF版をダウンロード</a></p>
@@ -68,6 +72,7 @@
    :caption: Appendix
 
    recommended
+   contributors
 
 .. todolist::
 

docs/.doctrees/index.doctree

@@ -26,7 +26,7 @@
 ------------------------------------
 
 フロントエンドの開発がリッチになってきていると同時に、開発におけるムーブメントもあります。それはブラウザで動作するJavaScriptを直接書かなくなっているということです。
-JavaScriptは2015年より前は保守的なアップデートがおこなわれていました。Netscape社(現Mozilla)が開発し、企業間のコンソーシアムで当初仕様が策定されていました。クラスを導入するという大規模アップデートを一度は目指したものの(ECMAScript 4)、その時は頓挫しました。しかし、ECMAScript 2015時点でクラス大幅なアップデートが加えられ、よりオープンなコミュニティ、EC39で議論されるようになりました。
+JavaScriptは2015年より前は保守的なアップデートがおこなわれていました。Netscape社(現Mozilla)が開発し、企業間のコンソーシアムで当初仕様が策定されていました。クラスを導入するという大規模アップデートを一度は目指したものの(ECMAScript 4)、その時は頓挫しました。しかし、ECMAScript 2015時点で大幅なアップデートが加えられ、よりオープンなコミュニティ、TC39で議論されるようになりました。
 
 しかし、ブラウザの組み込み言語である以上、サーバーアプリケーションのJavaやPythonのようにランタイムをアプリケーションに合わせて維持したり更新するといったことはできません。そのため、高度な文法を備える言語でコードを書き、トラディショナルなJavaScriptに変換するというアプローチが好まれるようになりました。CoffeeScriptなどが一時広く使われたものの、現在よく利用されているのはBabelとTypeScriptです。
 
@@ -136,4 +136,4 @@ core-jsのオプションが知りたい場合は、core-jsのサイトのREADME
 .. [#] Google I/O 2019で、これが現時点の最新版と同じChrome 74に更新されることが発表されています。
 .. [#] http://kangax.github.io/compat-table/es6/
 .. [#] Lambdaは長らくNode.js 6というかなり古いバージョンを使っていましたが10が提供されて6はサポート終了になり、Node.js 6ベースのタスクの新規作成と更新ができなくなりました。
-.. [#] https://www.npmjs.com/package/core-js
+.. [#] https://www.npmjs.com/package/core-js

docs/.doctrees/preface.doctree

@@ -14,7 +14,7 @@
 * ``null``
 
 このうち、それ以上分解できないシンプルなデータを「プリミティブ型」と呼びます。
-ここでは、よく出てくるプロミティブ型を紹介します。
+ここでは、よく出てくるプリミティブ型を紹介します。
 
 ``boolean`` リテラル
 ---------------------
@@ -215,7 +215,7 @@ TypeScriptには組み込みで2種類の数値型があります。
 * ``|0`` を末尾につける
 
 .. [#] 以前は ``Math.pow(x, y)`` という関数を使っていました。
-.. [#] ビット演算を多様する用途としては、遺伝子情報を高速に計算するのに使うFM-Indexといったアルゴリズムの裏で使われる簡潔データ構造と呼ばれるデータ構造があります。
+.. [#] ビット演算を多用する用途としては、遺伝子情報を高速に計算するのに使うFM-Indexといったアルゴリズムの裏で使われる簡潔データ構造と呼ばれるデータ構造があります。
 .. [#] ただし、ビット演算なので、本来扱えるよりもかなり小さい数字でしか正常に動作しません。
 
 特殊な数値

docs/.doctrees/primitive.doctree

@@ -25,7 +25,7 @@ Next.js（React）の環境構築
       :
       Happy hacking!
 
-なるべく、いろんなツールとの組み合わせの検証の手間を減らすために、Next.jsをつかいます。
+なるべく、いろんなツールとの組み合わせの検証の手間を減らすために、Next.jsを使います。
 JavaScriptは組み合わせが多くて流行がすぐに移り変わっていつも環境構築させられる（ように見える）とよく言われますが、組み合わせが増えても検証されてないものを一緒に使うのはなかなか骨の折れる作業で、結局中のコードまで読まないといけなかったりとか、環境構築の難易度ばかりが上がってしまいます。
 特にRouterとかすべてにおいて標準が定まっていないReactはそれが顕著です。