docs: content change

Author: Krzysztof Borowy

README.md

@@ -1,42 +1,42 @@
 # Async Storage
 
-A collection of persistent data storages, unified into a single API.
+A collection of persistent data storages, targeting different platforms, unified within a single API.
 
 ## Work in progress
 
 Async Storage v2 is under development.
 
-If you're looking for published and operational Async Storage version, please check out [`LEGACY`](https://github.com/react-native-community/async-storage/tree/LEGACY) branch. 
+If you're looking for published and operational Async Storage version, please check out [`LEGACY`](https://github.com/react-native-community/async-storage/tree/LEGACY) branch.
 
 ## Features
 
-- Unified API to consume any supported storage
-- Different type of storage for different purpose, see [available storages](#available-storages) 
-- Extensible functionality, to leverage full storage potential
-- Support for Mobile, Web and more
+- One, unified API to support different storages
+- [Extensible functionality](./packages/core/docs/API.md#extensions)
+- Targets Mobile, Web and more
+
 
 ## Getting started
 
 ### Install
 
-1. Get required core
+1. Install Core dependency
 
 ```bash
 yarn add @react-native-community/async-storage@next
 ```
 
-2. Pick desired [storage for your platform.](#available-storages) 
+2. Select a [storage for your platform.](#available-storages)
 
 
 ### Usage
 
-Example usage can [be found here.](./packages/core/docs/Usage.md)
+See usage can [be found here.](./packages/core/docs/Usage.md)
 
 
 ## Available storages
 
-- [Legacy](./packages/storage-legacy/README.md) - for React Native 
-- [Web](./packages/storage-web/README.md) - for Web applications
+- [Legacy](./packages/storage-legacy/README.md) - for React Native apps
+- [Web](./packages/storage-web/README.md) - for Web apps
 
 
 ## Documentation

examples/mobile/README.md

@@ -1,14 +1,16 @@
-# Async Storage mobile examples
+# Async Storage - Mobile example
 
-## Running the example
+Example React Native app presenting features of [`async-storage-backend-legacy`](https://github.com/react-native-community/async-storage/tree/master/packages/storage-legacy).
 
-1. Get dependencies
+## Running the app
+
+1. Install dependencies
 
 ```bash
 $ yarn install
 ```
 
-2. Install the app
+2. Run the app on either platform
 
 ```bash
 # Android
@@ -18,16 +20,9 @@ $ yarn start:android
 $ yarn start:ios
 ```
 
-3. Run packager
-
-```bash
-$ yarn start
-```
-
 ## Feedback
 
-Let me know about any issue found or feedback you have at [Async-Storage issue page](https://github.com/react-native-community/async-storage/issues).
-Please mark it as `examples` label.
+All feedback is welcome at [Async-Storage issue page](https://github.com/react-native-community/async-storage/issues).
 
 ## License
 

examples/web/README.md

@@ -1,23 +1,24 @@
-# Async Storage Web examples
+# Async Storage - Web example
 
-## Running the example
+Example React app presenting features of [`async-storage-backend-web`](https://github.com/react-native-community/async-storage/tree/master/packages/storage-web).
 
-1. Get dependencies
+## Running the app
+
+1. Install dependencies
 
 ```bash
 $ yarn install
 ```
 
-2. Run application
+2. Run the app
 
 ```bash
 $ yarn start
 ```
 
 ## Feedback
 
-Let me know about any issue found or feedback you have at [Async-Storage issue page](https://github.com/react-native-community/async-storage/issues).
-Please mark it as `examples` label.
+All feedback is welcome at [Async-Storage issue page](https://github.com/react-native-community/async-storage/issues).
 
 ## License
 

packages/core/docs/Usage.md

@@ -1,23 +1,27 @@
 # Async Storage usage
 
-Async Storage is a collection of usable storage backends for your App. 
+Async Storage is a collection of persistent storage for different platforms, with unified API.
 
-It comes in two parts: core and storage backend, you want to use.
+It comes in two parts: the core and storage itself.
 
-*Core* is a consumer of the storage, provides you a unified API to save and read data.
+*Core* - a consumer for the storage, provides a unified API to use it.
 
-*Storage backend* implements an interface that *core* API understands and uses. Its functionality depends on storage itself.
+*Storage backend* - platform-dependant implementation of persistent data storage.
 
 
 ## Install necessary dependencies
 
-In this example, we'll be using [Legacy storage](https://github.com/react-native-community/async-storage/tree/master/packages/storage-legacy).
+In this example, [Legacy storage](https://github.com/react-native-community/async-storage/tree/master/packages/storage-legacy) is used.
 
 ```bash
 # Install core
+
 $ yarn add @react-native-community/async-storage@next
+```
 
+```bash
 # Install legacy backend storage
+
 $ yarn add @react-native-community/async-storage-backend-legacy@next
 ```
 
@@ -35,6 +39,7 @@ const legacyStorage = new LegacyStorage();
 export type StorageModel = {
   user: {
     name: string
+    age: number
   }
 }
 
@@ -55,7 +60,8 @@ import storage from './storage.ts';
 
 async function saveItem() {
   const myUser = {
-    name: 'test'
+    name: 'John',
+    age: 22
   };
 
   await storage.set('user', myUser);

packages/core/docs/Writing_Storage_Backend.md

@@ -1,6 +1,6 @@
 # Authoring Storage Backend
 
-Async Storage is a [facade](https://en.wikipedia.org/wiki/Facade_pattern) over the underlying Storage solution. 
+Async Storage is a [facade](https://en.wikipedia.org/wiki/Facade_pattern) over the underlying Storage solution.
 In order for the new storage to be compatible, it has to implement `IStorageBackend` and its methods.
 
 
@@ -22,8 +22,8 @@ that simplifies access to the storage features. Those methods are:
 - `removeSingle`    - removes an entry for provided `key`
 - `getMany`         - returns an array of `values`, for a provided array of `keys`
 - `setMany`         - provided an array of `key-value` pairs, saves them to the storage
-- `removeMany`      - removes a bunch of values, for a provided array of `keys` 
-- `getKeys`         - returns an array of `keys` that were used to store values 
+- `removeMany`      - removes a bunch of values, for a provided array of `keys`
+- `getKeys`         - returns an array of `keys` that were used to store values
 - `dropStorage`     - purges the storage
 
 
@@ -34,7 +34,7 @@ Few points to keep in mind while developing new storage:
 
 
 
-## Going being default API
+## Going beyond the default API
 
 Unified API can be limiting - storages differ from each other and contain features that others do not. Async Storage comes with an extension property, that lets you extend its standard API.
 
@@ -86,13 +86,13 @@ async function removeOldEntries() {
 
 ## Example
 
-Let's create a storage backend for web, using `LocalStorage` API. 
+Let's create a storage backend for web, using `LocalStorage` API.
 
 Start by adding `AsyncStorage` to your dependencies.
 
 ```bash
 $ yarn add @react-native-community/async-storage
-``` 
+```
 
 Then, create a class and implement `IStorageBackend` interface;
 

packages/storage-legacy/README.md

@@ -1,9 +1,16 @@
 # Storage Backend: Legacy
 
-An `AsyncStorage` storage backend, fully compatible with former version.  
+Storage backend for `Async Storage`, targeting Mobile platform (React-Native). Compatible with [former version of `Async Storage`](https://github.com/react-native-community/async-storage/tree/LEGACY/).
 
 ## Installation
 
+1. Get the core
+
+```bash
+$ yarn add @react-native-community/async-storage@next
+```
+
+2. Get the the storage
 
 ```bash
 $ yarn add @react-native-community/async-storage-backend-legacy@next
@@ -12,7 +19,6 @@ $ yarn add @react-native-community/async-storage-backend-legacy@next
 
 ## Usage
 
-
 ```typescript
 
 import LegacyStorage from '@react-native-community/async-storage-backend-legacy';
@@ -26,7 +32,7 @@ const legacyStorage = new LegacyStorage();
 
 const storage = AsyncStorageFactory.create<MyModel>(legacyStorage);
 
-// ready to use
+
 export default storage;
 ```
 

packages/storage-web/README.md

@@ -1,15 +1,22 @@
 # Storage Backend: Web
 
-Storage backend for `AsyncStorage`, targeting Web platform.
+Storage backend for `Async Storage`, targeting Web platform.
 
 ## Installation
 
+1. Get the core
+
 ```bash
 $ yarn add @react-native-community/async-storage@next
+```
+
+2. Get the the storage
 
+```bash
 $ yarn add @react-native-community/async-storage-backend-web@next
 ```
 
+
 ## Usage
 
 ```typescript