Improve wording in README and documentation comments

README.md

@@ -48,7 +48,7 @@ lazyResource<T>(loader: () => Promise<T>, options?: ResourceOptions): Resource<T
 
 **Description**
 
-`lazyResource` is used to create a lazy resource. It's lazy because it will not start loading the resource immediately. Instead, it will start loading it only when the `load` method is called. The resource can be read at any point inside a React component - if it has not loaded at the time it is called, the component will suspend.
+`lazyResource` is used to create a lazy resource. It's lazy because it will not start loading the resource immediately. Instead, it will start loading it only when the `load` method is called. The resource can be read at any point inside a React component - if it has not loaded at the time it is read, the component will suspend.
 
 **Example**
 
@@ -79,7 +79,7 @@ interface Resource<T> {
 
 - `load: () => Promise<T>` begins loading the resource by calling the provided loader function. This method is idempotent - calling it after the first time has no effect. However, If the resource fails to load and `Resource#clearError()` is called (or `clearResourceErrors`), then calling this method will again begin loading the resource.
 
-- `read: () => T` returns the loaded resource. If the resource is still loading when this method is called, it will throw the resource promise, which will make the React component suspend and show the fallback of the nearest `<Suspense>` ancestor. If the resource failed to load, then this method will throw the error with which the promise rejected, causing the nearest error boundary ancestor to be hit. This method must be called inside a React component and it can only be called after the resource started loading with `Resource#load()`.
+- `read: () => T` returns the loaded resource. If the resource is still loading when this method is called, it will throw the resource promise, which will make the React component suspend and show the fallback of the nearest `<Suspense>` ancestor. If the resource failed to load, then this method will throw the error with which the promise rejected, causing the fallback of the nearest error boundary ancestor to be shown, if any. This method must be called inside a React component and it can only be called after the resource started loading with `Resource#load()`.
 
 ### `ResourceOptions`
 

src/lazyResource/index.ts

@@ -14,7 +14,7 @@ const resourcesWithError = new Set<Resource<unknown>>();
  * Creates a lazy resource. It's lazy because it will not start loading the
  * resource immediately. Instead, it will start loading it only when the `load`
  * method is called. The resource can be read at any point inside a React
- * component - if it has not loaded at the time it is called, the component
+ * component - if it has not loaded at the time it is read, the component
  * will suspend.
  * @param loader the loader function to load a resource of type `T`. This is a
  *    regular function that returns a promise.

src/types.ts

@@ -26,10 +26,10 @@ export interface Resource<T> {
    * method is called, it will throw the resource promise, which will make the
    * React component suspend and show the fallback of the nearest `<Suspense>`
    * ancestor. If the resource failed to load, then this method will throw the
-   * error with which the promise rejected, causing the nearest error boundary
-   * ancestor to be hit. This method must be called inside a React component
-   * and it can only be called after the resource started loading with
-   * `Resource#load()`.
+   * error with which the promise rejected, causing the fallback of nearest
+   * error boundary ancestor to be shown, if any. This method must be called
+   * inside a React component and it can only be called after the resource
+   * started loading with `Resource#load()`.
    */
   read: () => T;
 }