website ideas

[orta]

Website

Nav

Six main navigation components

• Homepage
• Handbook
• Guides
• Blog
• Playground
• Community

Then there is:

• Search (mostly focused on the handbook/guides could be built at build-time)

Optional, but maybe worth it? (if so, thinking from day one is useful)

• Translations

Homepage

Not been thought of too hard yet, but some ideas

• Own the unofficial-ts logo and make it official with a tiny tweak or two
• Note the breadth of DT typing of community
• Note the developer survey results for TS

I've done redesigns of a few big JS project homepages:

• https://jestjs.io/
• https://prettier.io/
• React Native's (wanted to work on it in private)
• Relay - https://github.com/facebook/relay/issues/2696

So, I feel pretty comfortable getting reasonable fidelity mockups and presenting those to some MS designers who can help make it fit better.

Handbook

Website may come out before new handbook, so have to build with the 2nd in mind.

Note that the URLs will change across handbooks, so ideally we keep a forwaring map of the closest approximation of pages

Guides

A general idea of the guides heirarchy

Getting Started

From Scratch

• With node
• With aspx
• For the browser
• With Azure (?!?!)
• Projects which support ts out of the box (react/angular/jest etc)

From an existing project

• Improve your tooling without adding adding dependencies

• Integration with build tools

  • Webpack
  • Babel
  • TSC

• Converting a JS project to TS (current guide)

  • Common migration patterns

Building at Scale

• How to migrate to TypeScript projects work
• TypeScript with lerna / yarn workspaces
• How to diagnose problems with TSServer
• Compiler Error index ( https://doc.rust-lang.org/error-index.html )

Definitely Typed

Migrate the content of the definitely typed website into TS and update it

• What is Definitely Typed?
• How do I add types to another library
  • Adding a library to DT
  • Adding types to a library

TypeSticter

A set of documents which guide you through turning on some of the strict flags in the tsconfig explaining with examples how they affect your code

• for noImplicitAny
• for noImplicitReturns
• for strictNullChecks
• for strictFunctionTypes

Blog

Same as current, maybe start encouraging folks write their own non-release notes post in there?

Playground

Embrace, extend and enhance typescript-play. I audited the code last night and it's pretty solid, and really simple.

Things we like which it supports:

• Multiple TS versions
• Strict by default

Extend:

• Nightly TS version (needs coordination with monaco-typescript which kinda controls which versions are available AT<>)
• Automatic type acquisition for imports
• More examples
• Make the compiled output semi-permenent, you can ask to see the compiled output
• Show tips

Export to

• convert current code to d.ts
• issue template ( which has a link for the nightly and prod release)
• Export to a Gist

Open code in

• Code Sandbox
• AST Explorer
• ts-ast-explorer

Stretch goals:

• Add support for text snippets
  • replace the 2nd panel with an inspector which shows rich information about current symbol selected
  • personal favourites / history
• create an edge extension that adds a run in playground anytime you see TS code blocks in markdown on github

Community

Talks to the scope of people using TS, how you can meet others to talk to it or learn more

• Meetups around the world
• Books
• TypeScript YouTube videos (Talks from us & others)

[orta]

"how do we handle JS"

[orta]

covers a lot of the flaws if you're a JS dev trying to add TypeScript definitions - https://hueniverse.com/24-hours-with-typescript-638485d61c87

[orta]

tsserver plugin dev notes dts linting for a JS + dts project

[orta]

lots of documents + samples for project references

[orta]

How to lint half js/ts projects: https://www.reddit.com/r/typescript/comments/caipx7/linting_a_half_js_half_ts_project/

[orta]

https://github.com/microsoft/TypeScript/issues/6499