Added more info about refs in the documentation (#8707)
Added more info about refs in the documentation (#8707)

* Update refs-and-the-dom.md

I want to propose some changes to the Refs and the DOM documentation page. 
- Make it clear that string refs are legacy. It seems that this information got lost during the transition to new docs and only some part stayed the same, which was confusing when first reading the docs.
- Clarify and explain that during render, if the ref callback is provided, it will get called twice, first with `null` and then with the rendered DOM element. Discussed in https://github.com/facebook/react/issues/4533 and first proposed docs change in PR #8333.

I've also planned on adding an example for passing the refs up the component chain based on something I've needed to solve myself (e.g. you want to connect two dynamic components by line in React, so you need to both use refs and propagate them up the chain), and while it would be great to read up on this in the docs, it may be too specific for this section; I'd be happy to hear any recommendations.

* Adds more specific information about the callback

* Moved the ref callback description to the Caveats section

* Fixed suggested nits

* Replace 'each render pass' with 'updates'

* Tweak the wording

krasimir/react,niubaba63/react,acdlite/react,terminatorheart/react,acdlite/react,silvestrijonathan/react,yiminghe/react,empyrical/react,rickbeerendonk/react,maxschmeling/react,tomocchino/react,jameszhan/react,rlugojr/react,camsong/react,kaushik94/react,niubaba63/react,pyitphyoaung/react,VioletLife/react,chicoxyzzy/react,nhunzaker/react,VioletLife/react,terminatorheart/react,yangshun/react,tomocchino/react,TheBlasfem/react,yangshun/react,rickbeerendonk/react,rricard/react,mhhegazy/react,kaushik94/react,chenglou/react,jquense/react,quip/react,aickin/react,roth1002/react,claudiopro/react,facebook/react,anushreesubramani/react,jquense/react,camsong/react,ericyang321/react,dilidili/react,mosoft521/react,krasimir/react,jameszhan/react,Simek/react,terminatorheart/react,yiminghe/react,TheBlasfem/react,jzmq/react,AlmeroSteyn/react,jquense/react,STRML/react,bspaulding/react,cpojer/react,billfeller/react,prometheansacrifice/react,richiethomas/react,rlugojr/react,ericyang321/react,chicoxyzzy/react,mhhegazy/react,Simek/react,chicoxyzzy/react,apaatsio/react,niubaba63/react,jorrit/react,VioletLife/react,glenjamin/react,apaatsio/react,wmydz1/react,flarnie/react,quip/react,syranide/react,terminatorheart/react,mjackson/react,shergin/react,AlmeroSteyn/react,trueadm/react,flarnie/react,syranide/react,flipactual/react,cpojer/react,ArunTesco/react,tomocchino/react,anushreesubramani/react,STRML/react,dilidili/react,yangshun/react,VioletLife/react,mjackson/react,jorrit/react,mhhegazy/react,camsong/react,wmydz1/react,flipactual/react,glenjamin/react,dilidili/react,jdlehman/react,leexiaosi/react,bspaulding/react,nhunzaker/react,maxschmeling/react,billfeller/react,camsong/react,jzmq/react,glenjamin/react,apaatsio/react,ericyang321/react,mosoft521/react,ArunTesco/react,jordanpapaleo/react,joecritch/react,claudiopro/react,shergin/react,yiminghe/react,roth1002/react,anushreesubramani/react,mjackson/react,rohannair/react,jameszhan/react,krasimir/react,flarnie/react,rohannair/react,empyrical/react,yungsters/react,jameszhan/react,andrerpena/react,silvestrijonathan/react,andrerpena/react,krasimir/react,jorrit/react,jordanpapaleo/react,shergin/react,trueadm/react,cpojer/react,prometheansacrifice/react,quip/react,glenjamin/react,TheBlasfem/react,andrerpena/react,glenjamin/react,terminatorheart/react,mhhegazy/react,kaushik94/react,bspaulding/react,claudiopro/react,camsong/react,brigand/react,rohannair/react,nhunzaker/react,jzmq/react,Simek/react,prometheansacrifice/react,facebook/react,anushreesubramani/react,empyrical/react,kaushik94/react,maxschmeling/react,apaatsio/react,wmydz1/react,wmydz1/react,AlmeroSteyn/react,rricard/react,cpojer/react,silvestrijonathan/react,billfeller/react,trueadm/react,sekiyaeiji/react,rlugojr/react,jordanpapaleo/react,edvinerikson/react,STRML/react,jorrit/react,facebook/react,ArunTesco/react,acdlite/react,anushreesubramani/react,Simek/react,mosoft521/react,mosoft521/react,rricard/react,shergin/react,edvinerikson/react,Simek/react,quip/react,prometheansacrifice/react,pyitphyoaung/react,trueadm/react,richiethomas/react,leexiaosi/react,chenglou/react,AlmeroSteyn/react,brigand/react,jorrit/react,leexiaosi/react,shergin/react,VioletLife/react,bspaulding/react,silvestrijonathan/react,STRML/react,yungsters/react,roth1002/react,VioletLife/react,rickbeerendonk/react,rricard/react,jzmq/react,jameszhan/react,flipactual/react,tomocchino/react,TheBlasfem/react,chenglou/react,quip/react,prometheansacrifice/react,empyrical/react,glenjamin/react,trueadm/react,ericyang321/react,facebook/react,facebook/react,edvinerikson/react,flarnie/react,Simek/react,apaatsio/react,claudiopro/react,acdlite/react,niubaba63/react,billfeller/react,niubaba63/react,flarnie/react,jordanpapaleo/react,rricard/react,anushreesubramani/react,rickbeerendonk/react,aickin/react,cpojer/react,empyrical/react,bspaulding/react,acdlite/react,mhhegazy/react,chicoxyzzy/react,jdlehman/react,empyrical/react,rlugojr/react,jzmq/react,jquense/react,kaushik94/react,quip/react,jdlehman/react,andrerpena/react,kaushik94/react,rickbeerendonk/react,andrerpena/react,yiminghe/react,silvestrijonathan/react,chenglou/react,pyitphyoaung/react,STRML/react,niubaba63/react,mosoft521/react,richiethomas/react,rohannair/react,apaatsio/react,joecritch/react,chicoxyzzy/react,TheBlasfem/react,brigand/react,acdlite/react,jdlehman/react,yangshun/react,edvinerikson/react,flarnie/react,camsong/react,apaatsio/react,krasimir/react,anushreesubramani/react,bspaulding/react,aickin/react,joecritch/react,nhunzaker/react,chicoxyzzy/react,wmydz1/react,joecritch/react,chenglou/react,chenglou/react,jquense/react,shergin/react,pyitphyoaung/react,maxschmeling/react,roth1002/react,yungsters/react,yungsters/react,yungsters/react,nhunzaker/react,STRML/react,prometheansacrifice/react,mhhegazy/react,billfeller/react,jameszhan/react,jquense/react,rohannair/react,Simek/react,jordanpapaleo/react,jdlehman/react,richiethomas/react,glenjamin/react,jzmq/react,AlmeroSteyn/react,claudiopro/react,STRML/react,silvestrijonathan/react,nhunzaker/react,billfeller/react,jorrit/react,richiethomas/react,sekiyaeiji/react,brigand/react,jzmq/react,mosoft521/react,maxschmeling/react,empyrical/react,roth1002/react,yiminghe/react,edvinerikson/react,rickbeerendonk/react,claudiopro/react,terminatorheart/react,ericyang321/react,yangshun/react,VioletLife/react,mjackson/react,ericyang321/react,chenglou/react,facebook/react,ericyang321/react,mhhegazy/react,cpojer/react,claudiopro/react,pyitphyoaung/react,jdlehman/react,niubaba63/react,shergin/react,rricard/react,aickin/react,facebook/react,roth1002/react,yungsters/react,rlugojr/react,billfeller/react,jorrit/react,pyitphyoaung/react,jdlehman/react,rohannair/react,krasimir/react,mjackson/react,krasimir/react,trueadm/react,yiminghe/react,richiethomas/react,joecritch/react,wmydz1/react,wmydz1/react,acdlite/react,maxschmeling/react,joecritch/react,nhunzaker/react,roth1002/react,tomocchino/react,jameszhan/react,sekiyaeiji/react,syranide/react,mosoft521/react,dilidili/react,prometheansacrifice/react,camsong/react,dilidili/react,aickin/react,yiminghe/react,brigand/react,joecritch/react,richiethomas/react,mjackson/react,yangshun/react,rlugojr/react,brigand/react,brigand/react,maxschmeling/react,rlugojr/react,bspaulding/react,silvestrijonathan/react,rickbeerendonk/react,kaushik94/react,andrerpena/react,cpojer/react,edvinerikson/react,jordanpapaleo/react,edvinerikson/react,dilidili/react,rohannair/react,pyitphyoaung/react,chicoxyzzy/react,aickin/react,jquense/react,mjackson/react,TheBlasfem/react,quip/react,yungsters/react,tomocchino/react,trueadm/react,syranide/react,AlmeroSteyn/react,aickin/react,tomocchino/react,jordanpapaleo/react,flarnie/react,yangshun/react,dilidili/react,AlmeroSteyn/react