docs: improve docs

Author: andipaetzold

README.md

@@ -7,7 +7,8 @@ A set of reusable [React Hooks](https://reactjs.org/docs/hooks-intro.html) for [
 [![npm version](https://img.shields.io/npm/v/react-firebase-hooks.svg?style=flat-square)](https://www.npmjs.com/package/react-firebase-hooks)
 [![npm downloads](https://img.shields.io/npm/dm/react-firebase-hooks.svg?style=flat-square)](https://www.npmjs.com/package/react-firebase-hooks)
 
-This documentation is for v4 of React Firebase Hooks which involved a number of breaking changes, including adding support for Firebase v9 - more details [here](https://github.com/CSFrequency/react-firebase-hooks/releases/tag/v4.0.0). 
+This documentation is for v4 of React Firebase Hooks which makes the package compatible with Firebase v9 and drops support for previous versions of Firebase - more details [here](https://github.com/CSFrequency/react-firebase-hooks/releases/tag/v4.0.0).
+
 - For v3 documentation (Firebase v8), see [here](https://github.com/CSFrequency/react-firebase-hooks/tree/v3.0.0).
 - For v2 documentation, see [here](https://github.com/CSFrequency/react-firebase-hooks/tree/v2.2.0).
 
@@ -33,10 +34,6 @@ There has been a **lot** of hype around React Hooks, but this hype merely reflec
 
 This library explores how React Hooks can work to make integration with Firebase even more straightforward than it already is. It takes inspiration for naming from RxFire and is based on an internal library that we had been using in a number of apps prior to the release of React Hooks. The implementation with hooks is 10x simpler than our previous implementation.
 
-## Upgrading from v3 to v4
-
-To upgrade your project from v3 to v4 check out the [Release Notes](https://github.com/CSFrequency/react-firebase-hooks/releases/tag/v4.0.0) which have full details of everything that needs to be changed.
-
 ## Upgrading from v2 to v3
 
 To upgrade your project from v2 to v3 check out the [Release Notes](https://github.com/CSFrequency/react-firebase-hooks/releases/tag/v3.0.1) which have full details of everything that needs to be changed.

auth/README.md

@@ -1,6 +1,6 @@
 # React Firebase Hooks - Auth
 
-React Firebase Hooks provides a convenience listener for Firebase Auth's auth state. The hook wraps around the `auth.onAuthStateChange(auth.getAuth(firebaseApp))` method to ensure that it is always up to date.
+React Firebase Hooks provides a convenience listener for Firebase Auth's auth state. The hook wraps around the `auth.onAuthStateChange(...)` method to ensure that it is always up to date.
 
 All hooks can be imported from `react-firebase-hooks/auth`, e.g.
 

database/README.md

@@ -1,7 +1,7 @@
 # React Firebase Hooks - Realtime Database
 
 React Firebase Hooks provides convenience listeners for lists and values stored within the
-Firebase Realtime Database. The hooks wrap around the `onX(ref(firebase, 'path'), ...)` method.
+Firebase Realtime Database. The hooks wrap around the `onX(...)` method.
 
 In addition to returning the list or value, the hooks provide an `error` and `loading` property
 to give a complete lifecycle for loading and listening to the Realtime Database.

firestore/README.md

@@ -1,7 +1,6 @@
 # React Firebase Hooks - Cloud Firestore
 
-React Firebase Hooks provides convenience listeners for Collections and Documents stored with Cloud Firestore. The hooks wrap around the `onSnapshot(collection(...))`
-and `firestore.onSnapshot(firestore.doc(...))` methods.
+React Firebase Hooks provides convenience listeners for Collections and Documents stored with Cloud Firestore. The hooks wrap around the `firestore.onSnapshot(...)` method.
 
 In addition to returning the snapshot value, the hooks provide an `error` and `loading` property
 to give a complete lifecycle for loading and listening to Cloud Firestore.

storage/README.md

@@ -1,7 +1,7 @@
 # React Firebase Hooks - Cloud Storage
 
 React Firebase Hooks provides convenience listeners for files stored within
-Firebase Cloud Storage. The hooks wrap around the `getDownloadURL(ref(storage, 'path/to/file'))` method.
+Firebase Cloud Storage. The hooks wrap around the `getDownloadURL(...)` method.
 
 In addition to returning the download URL, the hooks provide an `error` and `loading` property
 to give a complete lifecycle for loading from Cloud Storage.