New guides wanted

[bvaughn]

Note this issue has some overlap with FAQ section issue #29.

We revamped the docs, but there are a few guides that are missing and that I think are essential.

Available

• @mateoholman Community section with good resources (e.g. Add Learning Resources section to the Community Resources on the website facebook/react#7117)
• @mrscobbler Glossary (similar to "Virtual DOM Terminology" that is now gone, but more friendly. Check http://redux.js.org/docs/Glossary.html for inspiration.)
• @chiangs Troubleshooting (there are ~5 common issues we should explain right away, like wrong element casing, not loaded DOM container, missing React in scope, etc. See http://redux.js.org/docs/Troubleshooting.html for inspiration)
• @madhug Manipulating Children (Using cloneElement and Children React.cloneElement docs are a bit light facebook/react#6942)
• "Portals" (useful for modals)
• @mateoholman Animation with React Motion
• @jamesknelson Routing (no need to use React Router here, just show how to use setState with HTML5 history API and point to RR as a component-based API for it once v4 is out)
• @ishankbahl Snapshot testing (Write documentation for react-test-renderer facebook/react#7431)
• @mateoholman Publishing a Component (Docs request: build a React component library facebook/react#7882)

In progress

• @alexkrolick, @ishankbahl: AJAX (just show how to use fetch() in lifecycles, mention cancellation issues)

If somebody wants to work on this please comment here and let's figure out a plan. Help wanted!

Carry over from facebook/react/issues/8060

[markerikson]

The ReactPerf item may sorta be OBE ("overtaken by events"), since it's not included in v16.

[bvaughn]

Not sure what that acronym means but I assume you're suggesting we should remove it? 😄 I don't object.

[JasonEtco]

Not sure if you're already planning it, but I would add Didn't bind class methods to common troubleshooting issues 👍

[markerikson]

@bvaughn : yeah, that's what I was suggesting :)

@JasonEtco : the "troubleshooting" suggestion overlaps heavily with the proposal for an FAQ page.

[AlmeroSteyn]

@bvaughn Accessibility has been added and can be checked off :-)

[mrscobbler]

I'll take the glossary that I created in the old repo and migrate it to the new docs repo

[alexkrolick]

As @markerikson mentioned there is some overlap with the FAQ discussion (#29). PR #43 covers AJAX and some of the VDOM concepts although a full-fledged glossary would probably replace that section.

[bvaughn]

Thanks @AlmeroSteyn. I've removed that entry.

Yeah, there's some overlap. I spent a few hours merging/moving issues and PRs yesterday but some of the larger/vaguer ones like this are a bit hard to do without a bit of overlap. I'll add a note in the description about the relationship.

[ishankbahl]

Hey @bvaughn , I would like to work on "AJAX (just show how to use fetch() in lifecycles, mention cancellation issues)". Though now we don't have to talk about cancellation issues as fetch now supports abort https://developers.google.com/web/updates/2017/09/abortable-fetch
Can I take this one?

[bvaughn]

It's all yours, @ishankbahl