reorg Advanced guides

CONTRIBUTING.md

@@ -10,3 +10,39 @@ I thought I should lay out some core principles that we will follow so that this
 4. **Add TypeScript Playground Links**: Whenever adding a code example longer than four lines, add a link to the TypeScript Playground with the code. Use the default compiler Playground options.
 
 That's all I've got! Again, really happy you are thinking about helping out, who knows, the person who you might be helping is yourself in future!
+
+## Project structure
+
+- All content is in `/docs`
+  - the `/docs/basic` is compiled into `README.md` to preserve GitHub readability via GitHub action, thanks
+- `/website` consumes the `/docs` content, which is a [Docusaurus 2](https://docusaurus.io/) site, which also has [Algolia search](https://www.algolia.com/) (thanks to both teams for their support!)
+
+The website is deployed to Netlify on swyx's personal account.
+
+To run the docsite locally:
+
+```bash
+yarn # install deps
+## make sure deps are installed in /website too
+cd website && yarn start
+```
+
+example output from successful startup
+
+```
+yarn run v1.22.4
+warning package.json: No license field
+$ docusaurus start
+Starting the development server...
+
+✔ Client
+  Compiled successfully in 9.61s
+
+ℹ ｢wds｣: Project is running at http://localhost:3000/
+ℹ ｢wds｣: webpack output is served from /
+ℹ ｢wds｣: Content not from webpack is served from /Users/wanshawn/Work/react-typescript-cheatsheet/website
+ℹ ｢wds｣: 404s will fallback to /index.html
+
+✔ Client
+  Compiled successfully in 116.41ms
+```

README.md

@@ -25,7 +25,7 @@
 
 <div align="center">
 
-:wave: This repo is maintained by [@swyx](https://twitter.com/swyx), [@ferdaber](https://twitter.com/ferdaber), [@eps1lon](https://twitter.com/sebsilbermann), [@IslamAttrash](https://twitter.com/IslamAttrash), [@jsjoeio](https://twitter.com/jsjoeio) and [@arvindcheenu](https://twitter.com/arvincheenu), we're so happy you want to try out TypeScript with React! If you see anything wrong or missing, please [file an issue](https://github.com/typescript-cheatsheets/react-typescript-cheatsheet/issues/new/choose)! :+1:
+:wave: This repo is maintained by [@swyx](https://twitter.com/swyx), [@ferdaber](https://twitter.com/ferdaber), [@eps1lon](https://twitter.com/sebsilbermann), [@jsjoeio](https://twitter.com/jsjoeio) and [@arvindcheenu](https://twitter.com/arvincheenu), we're so happy you want to try out TypeScript with React! If you see anything wrong or missing, please [file an issue](https://github.com/typescript-cheatsheets/react-typescript-cheatsheet/issues/new/choose)! :+1:
 
 </div>