Add TS and React

De-link javascript-promises.md because it's not good
Leave Spike link for now, but mark deprecated

Author: msssk

fundamentals.md

@@ -6,6 +6,7 @@
 	1. [Configuration](tools/code-editor.md#installation-and-configuration)
 1. Programming languages
 	1. [JavaScript](languages/javascript.md)
+	1. [TypeScript](languages/typescript.md)
 	1. [JSON](languages/json.md)
 	1. [Markdown](languages/markdown.md)
 1. Development tools

languages/javascript.md

@@ -4,7 +4,7 @@
 
 1. Variables and scope
 1. `let` and `const`
-1. Promises
+1. Promises [Web Fundamentals](https://developers.google.com/web/fundamentals/primers/promises), [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises)
 1. XMLHttpRequest (XHR)
 1. Events
 1. Errors and `try/catch`
@@ -17,4 +17,3 @@
 * [MDN JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide)
 * [MDN JavaScript Reference](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference)
 * [MDN Browser and DOM Reference](https://developer.mozilla.org/en-US/docs/Web/API)
-* [Promises](javascript-promises/javascript-promises.md)

languages/typescript.md

@@ -0,0 +1,11 @@
+# TypeScript
+
+TypeScript is a superset of JavaScript, which means that all JS is valid TS. TS extends JS with type information.
+Type information enables static analysis (performed by the TS compiler) to detect a number of bugs. It also helps
+developers understand code more easily by communicating exactly what type of data is expected and acceptable.
+Visual Studio Code displays type information which makes editing code easier.
+
+## Learning TypeScript
+
+* [TypeScript Deep Dive](https://basarat.gitbooks.io/typescript/content/docs/getting-started.html)
+* [Official documentation](http://www.typescriptlang.org/docs/home.html)

ui/advanced.md

@@ -11,7 +11,8 @@
 
 ## Tools and frameworks
 
-1. [Spike](spike.md)
+1. [React](react.md)
+1. [~~Spike~~](spike.md) (deprecated)
 1. [Shoelace](shoelace.md)
 1. [Apache HTTP server](http://httpd.apache.org/)
 1. [nginx HTTP server](https://nginx.org/en/)

ui/react.md

@@ -0,0 +1,17 @@
+# React
+
+React is a JS UI library that helps build component-based, stateful, performant applications. React itself does not
+provide UI components. Our component library of choice is [Material UI](https://material-ui.com/), a React
+implementation of Google's Material Design. React is used in [Gatsby](https://www.gatsbyjs.org).
+
+## Learn React
+
+* [Official docs](https://reactjs.org/docs/hello-world.html) (read at least Main Concepts and Advanced Guides)
+* [Redux](https://redux.js.org/basics) (read Basics and Advanced)
+
+## Component design
+
+1. Start with a completely stateless UI - build the UI elements in JSX, accepting props as needed
+1. If the component meets the needs then you are done!
+1. If you need to fetch or calculate data, manipulate props, or manage state, rename your module to `MyModuleTemplate`
+1. Now create a new `MyModule` and add all necessary logic, passing props and handlers to `MyModuleTemplate`