typescript-book-ja / typescript-book-jp Goto Github PK

typescript-book-jp/future-javascript/generators.md
の83行目にて

ここまで、ジェネレータにを使った通信は、ほとんどがジェネレータがイテレータの値を返す、一方向のものでした。JavaScriptのジェネレータの非常に強力な機能の1つは、双方向の通信を可能にすることです!

とありますが、ジェネレータにを、ではなく、ジェネレータを、ではないでしょうか？

issueを出したことがないので、適していない出し方をしていたら申し訳ございません。
修正をお願い致します。

Contributorsの画像サイズが大きく、横スクロールしないと全て表示できない状態になっています。

#98 で @shuji さんが対応してくれた残りの最新化が必要

• Introduction
• Getting Started
• JavaScript
• Future JavaScript Now
• Project
• Node.js QuickStart
• Browser QuickStart
• Library QuickStart
• TypeScript's Type System
• JSX
• Options
• Errors in TypeScript
• NPM
• Testing
• Tools
• TIPs
• StyleGuide
• TypeScript Compiler Internals

ほとんどのページにおいて、各セクションのページ内リンクが自動生成されたものになってしまっています。
たとえば、「JavaScriptを改善する」は、次のようなロジックでアルファベットの文字列「javascriptwosuru」に変換されています。

• "JavaScript" -> "javascript"
• "を" -> "wo"
• "改善" -> ""（漢字は単に無視されるようです）
• "する" -> "suru"

自動生成された文字列は不完全なので、次のいずれかの方法で明示的にid属性を指定すべきでしょう。

• A：見出しのid属性に実際の見出し（日本語）を指定する

<h2 id="JavaScriptを改善する">JavaScriptを改善する</h2>

• B：見出しのid属性に本家と同じものを指定する

<h2 id="making-javascript-better">JavaScriptを改善する</h2>

いずれにせよ、目次のほうも合わせて修正が必要になるかと思います。

サンプルコードのコメントのほとんどが英語のままです。これを理解しやすいように日本語化する必要があります。

クロージャのページの2つ目のサンプルコードのコメント文に誤りがあります。

最後の関数を実行したさい、hello closure!と表示されるはずですが、コメント文にはエクスクラメーションマークがありません。
https://typescript-jp.gitbook.io/deep-dive/recap/closure

英語
https://basarat.gitbook.io/typescript/recap/closure

Getting Started - TypeScript Deep Dive 日本語版

こちらのページの冒頭のリンクが機能していないようです。

短いページですし、削除してしまってもよいかと思います。いかがでしょうか？

**版では Contributors のテーブルを GitBook 上でのみ非表示にしている。
同じようにしたいけど、どうやっているのか分からない・・。

https://github.com/jkchao/typescript-book-chinese
https://jkchao.github.io/typescript-book-chinese/

Index Signaturesのすべてのメンバはstringインデックスシグネチャに従わなければならないのコード例が元ファイル（docs/types/index-signatures.md）上では

/** Okay */
interface Foo {
  [key:string]: number
  x: number;
  y: number;
}

となっていて正しいと思われますが、typescript-jp.gitbook.ioでの表示上は

/** Okay */
interface Foo {
  x: number;
  y: number;
}

という表示になっており、元ファイル（docs/types/index-signatures.md）上には存在する[key:string]: numberがなぜか表示されていません。