Official TypeScript GitHub board on updating the specification
github.com/microsoft/TypeScript/projects/7Posted Oct 23, 2019, 1:25 PM UTC
Posted Oct 23, 2019, 1:25 PM UTC
Agile at its essence
I don’t think TS has ever abided by its spec document. The spec is pretty much whatever the compiler’s behavior (buggy or not) is at that moment.
I followed the official thread on this over on GitHub and they said they were not going to update the spec, and delete the link from the main site. Many people were horrified, but this was brushed under the carpet.
There were various noises about concentrating on https://github.com/microsoft/TypeScript-New-Handbook instead, but the pace on that is glacial, so we might all be dead before that is a usable resource :)
I am very confused by why TS has such awful docs, everything else is so amazing. Having release notes as the only official source of documentation on features is ... really?!
https://www.typescriptlang.org/docs/home.html
Click to 'whats new', and that is it? Just a random list of things as they add them.
If anyone with authority is reading this, PLEASE divert some more time/energy/money into the new Handbook, lack of a spec/decent docs is the biggest black mark on TypeScript right now.
Hasn't been updated since 2017 unfortunately...