wgao19 / flow-notes Goto Github PK

Motivations

• To have a home place where people can refer back for Flow problems
• To have people collectively share knowledge about Flow

Current Flow material

This is an incomplete list of things done well around Flow. The intention is not to make judgement, but rather to serve as references to existing materials and as planner for missing pieces.

• Flow docs has complete basic types and Algolia search
• Very good commit messages
• Very good tests in both facebook/flow and flow-typed
• Release notes are getting better
• Blog posts are well-written and insightful

What's missing

Content of this repo I guess

• Notes by version / upgrade guides topic
• CodeSandboxes for more complex demos than Try Flow bookmarklets
• Problem solving (Flow docs has an FAQ page but it's a single page collection of questions and answers without a table of content, so it is not very easy to browse around)
• Flow practices / cookbook / how-to guides
• Troubleshooting with tooling, IDE support, configuration with prettier and babel, etc.

Reference projects

• https://github.com/typescript-cheatsheets/react-typescript-cheatsheet
• https://github.com/microsoft/TypeScript-New-Handbook
• https://github.com/piotrwitek/react-redux-typescript-guide
• https://github.com/niieani/typescript-vs-flowtype

Check this out https://github.com/lttb/flown

Regarding React component types:

• Add examples and brief descriptions of how they're used
• Make it version-neutral (remove "new" and mark the version numbers)
• Reference to test files inside Flow repo

Try Flow

from facebook/flow#7834