Guided Tour of the TS website

TODO.md

1. Roadmap: microsoft/TypeScript-Website#94

2. Updates: microsoft/TypeScript-Website#130

3. Design - Figma

   1. First joined, did prototype designs for playground https://www.figma.com/file/Q0872II3wi1EzCXV9eUNBqb7/Playground?node-id=5%3A87
   2. From that design went back to a doc page https://www.figma.com/file/x8FJrNqj6oupqWn1s3uMg4/Website?node-id=7%3A1
   3. From doc page went to https://www.figma.com/file/x8FJrNqj6oupqWn1s3uMg4/Website?node-id=1%3A129

4. Dev: Start off, what is Gatsby -> https://www.gatsbyjs.org

5. Why do I think Gatsby is a good fit -> https://www.gatsbyjs.org/blog/2020-01-23-why-typescript-chose-gatsby/

6. Mono-repo packages -> https://github.com/microsoft/TypeScript-Website/tree/v2/packages

7. Simple page /empty -> http://www.typescriptlang.org/v2/empty

   1. Example code: https://github.com/microsoft/TypeScript-Website/blob/v2/packages/typescriptlang-org/src/templates/pages/empty.tsx

8. More complex page /docs/home -> http://www.typescriptlang.org/v2/docs/home

   1. Code: https://github.com/microsoft/TypeScript-website/blob/v2/packages/typescriptlang-org/src/templates/pages/docs/home.tsx

9. Doc Generation

   1. https://github.com/microsoft/TypeScript-Website/tree/v2/packages/handbook-v1/en
   2. https://github.com/microsoft/TypeScript-Website/tree/v2/packages/playground-examples
   3. https://github.com/microsoft/TypeScript-Website/tree/v2/packages/tsconfig-reference

10. i8n

    1. Overview microsoft/TypeScript-Website#100
    2. Writeup: microsoft/TypeScript-Website#130 (comment)
    3. Incrementally applied, compare /ja/ with /en/ in playground-examples
    4. Grabbed at build time and pages are created per-lang here -> https://github.com/microsoft/TypeScript-Website/blob/v2/packages/typescriptlang-org/lib/bootup/ingestion/createPlaygrounds.ts
    5. URLs are all in English, special linking code looks at all URLs to determine if you can stay in lang: https://github.com/microsoft/TypeScript-Website/blob/v2/packages/typescriptlang-org/src/components/IntlLink.tsx

11. Automation

    1. Deploys
       1. Prod - https://github.com/microsoft/TypeScript-Website/blob/master/.github/workflows/Release.yml
       2. Staging - https://github.com/microsoft/TypeScript-Website/blob/master/.github/workflows/Staging.yml
    2. Code Owners
       1. https://github.com/microsoft/TypeScript-repos-automation
       2. https://github.com/microsoft/TypeScript-Website/blob/v2/.github/CODEOWNERS
    3. Danger
       1. Spell Check - microsoft/TypeScript-Website#47 (comment)
       2. a11y audit - microsoft/TypeScript-Website#173 (comment)
       3. visual changes - microsoft/TypeScript-Website#250

12. New tools

    1. Twoslash: http://www.typescriptlang.org/v2/dev/twoslash
    2. Sandbox: http://www.typescriptlang.org/v2/dev/sandbox
    3. Playground Plugins: http://www.typescriptlang.org/v2/dev/playground-plugins
    4. typescript-vfs: https://github.com/microsoft/TypeScript-Website/tree/v2/packages/typescript-vfs