typescript-tutorial icon indicating copy to clipboard operation
typescript-tutorial copied to clipboard

为什么写本书,感觉写得不对

Open andyzhaozhao opened this issue 6 years ago • 4 comments
trafficstars

“TypeScript 虽然有官方手册及其非官方中文版,但是它每一章都希望能详尽的描述一个概念,导致前面的章节就会包含很多后面才会学习到的内容,而有些本该一开始就了解的基础知识却在后面才会涉及。如果是初学者,可能需要阅读多次才能理解。所以它更适合用来查阅,而不是学习。”这一段,我觉得不成立。因为官网包含quick start或者tutorials这种快速入门类文档,也包括reference或者handbook这种供查阅用的手册。设置还包含处于中间位置的guideline文档。

andyzhaozhao avatar Nov 13 '19 09:11 andyzhaozhao

可能你属于那种编程基础比较扎实的程序员,看一遍就可以理解。 但大部分 js 基础不太好的人对 ts 的官方文档早就怨声载道了,百度谷歌可以查到很多抱怨我就不贴过来了。

实际上 ts 官方也发现了自己的文档对入门者不友好,所以 ts 官方也在着手重新整理官网了:

  • 这里汇集了各种各样对官方网站和官方文档的吐槽
  • 这里是 2019-10-23 官方给出的新版网站和新版文档的 roadmap

xcatliu avatar Nov 13 '19 09:11 xcatliu

不便之处,敬请见谅,我不会说中文。

我也试图在即将发布的文档版本中获得正式翻译。 也许将来,该存储库可以帮助进行翻译。

看到 https://github.com/microsoft/TypeScript-Website/issues/100

orta avatar Nov 20 '19 21:11 orta

@orta Thanks for your attention. Actually this repo is an e-book for typescript beginner written by me. It's not a translation.

There is a translated version of typescriptlang.org: https://www.tslang.cn/docs/handbook/basic-types.html

The repos are

  • The translation: https://github.com/zhongsp/TypeScript
  • The website: https://github.com/mishengqiang/tslang.cn

I think you can call @zhongsp to help authorize the Chinese translation

Additionally, I am willing to help build the new typescriptlang.org, if there is anything I can help, feel free to tell me!

祝 TypeScript 越来越好!

xcatliu avatar Nov 21 '19 02:11 xcatliu

大家好,时间到了

我们已经开始提供日文和西班牙文版本!

如果可以找到时间,请在TypeScript社区不和谐中跟我打招呼

https://discord.gg/typescript

orta avatar Feb 12 '20 03:02 orta