Improve the autorefresh documentation

Remove the claims that refreshing and notifications happen "immediately"
as they're actually only enqueued immediately, and go into a bit more
detail about how things work.
Fix a bunch of small errors in the RLMRealm docs
Improve the migration documentation

Move the main explanation of stuff from the documentation block for the
typedef to the doc blocks for the methods and (hopefully) improve the
wording a bit. While this results in most of the documentation being
duplicated, appledoc doesn't actually document typedefs so it didn't
show up in the generated HTML at all previously.
Fix some typos
Improve the migration documentation more
Merge pull request #828 from realm/tg-autorefresh-docs

Improve the RLMRealm documentation a bit
License details; let us know about your apps!
Update README.md
Update README.md
Update README.md
Actually report failure from build.sh when a test fails
Merge pull request #842 from realm/tg-test-report-failure

Actually report failure from build.sh when a test fails
updated CONTRIBUTING.md with guides to filing issues and contributing code
small modifications from PR feedbacl
Merge pull request #843 from realm/jp-contributing

updated CONTRIBUTING.md with guides to filing issues and contributing code
Document RLMRealm lifetimes and related issues

Should cover all of the points of confusion related to RLMRealm
lifetimes that people have run in to.
Merge pull request #844 from realm/tg-rlmrealm-docs

Document RLMRealm lifetimes and related issues
Upgrade core library version 0.82.1 -> 0.82.2
Merge pull request #847 from realm/ks-use-core-ver-0.82.2

Upgrade core library version 0.82.1 -> 0.82.2
create tableview on demand