docs: Cleaned up English grammar in a few more places

Author: PaulMest

config/.mocharc.js

@@ -6,16 +6,18 @@ const mochaSettings = {
     exit: true,
     reporter: 'spec'
 };
+
 if (process.env.TRAVIS) {
     // this is so high because travis has different machines
     // that are randomly slow
     mochaSettings.timeout = 120 * 1000;
     mochaSettings.reporter = 'min';
-};
+}
+
 if (process.env.NODE_PROF) {
-    console.log('profiler actived:');
+    console.log('profiler activated:');
     mochaSettings.prof = true;
     mochaSettings.bail = false;
 }
 
-module.exports = mochaSettings;
+module.exports = mochaSettings;

docs-src/adapters.md

@@ -1,19 +1,19 @@
 # PouchDB Adapters
 
-When you use the PouchDB `RxStorage`, there are many adapters that define where the data has to be stored.
-Depending on which environment you work in, you can choose between different adapters. For example in the browser you want to store the data inside of IndexedDB but on NodeJs you want to store the data on the filesystem.
+When you use PouchDB `RxStorage`, there are many adapters that define where the data has to be stored.
+Depending on which environment you work in, you can choose between different adapters. For example, in the browser you want to store the data inside of IndexedDB but on NodeJS you want to store the data on the filesystem.
 
 This page is an overview over the different adapters with recommendations on what to use where.
 
-**Please always ensure that your pouchdb adapter-version is the same as `pouchdb-core` in the [rxdb package.json](https://github.com/pubkey/rxdb/blob/master/package.json). Otherwise you might have strange problems**
+**Please always ensure that your pouchdb adapter-version is the same as `pouchdb-core` in the [rxdb package.json](https://github.com/pubkey/rxdb/blob/master/package.json). Otherwise, you might have strange problems**
 
 # Any environment
 
 ## Memory
 In any environment, you can use the memory-adapter. It stores the data in the javascript runtime memory. This means it is not persistent and the data is lost when the process terminates.
 
 Use this adapter when:
-  - You want to have a really good performance
+  - You want to have really good performance
   - You do not want persistent state, for example in your test suite
 
 ```js

docs-src/plugins.md

@@ -1,8 +1,8 @@
 # Creating Plugins
 
-Creating an own plugin is very simple. A plugin is basically an javascript-object which overwrites or extends RxDB's internal classes, prototypes and hooks.
+Creating your own plugin is very simple. A plugin is basically a javascript-object which overwrites or extends RxDB's internal classes, prototypes, and hooks.
 
-A basic plugins:
+A basic plugin:
 
 ```javascript
 
@@ -12,7 +12,7 @@ const myPlugin = {
          * (optional) init() method
          * that is called when the plugin is added to RxDB for the first time.
          */
-        init(){
+        init() {
             // import other plugins or initialize stuff
         },
         /**
@@ -27,13 +27,13 @@ const myPlugin = {
              * @param {object} prototype of RxCollection
              */
             RxCollection: (proto) => {
-                proto.hello = function(){
+                proto.hello = function() {
                     return 'world';
                 };
             }
         },
         /**
-         * some methods are static and can be overwritten in the overwriteable-object
+         * some methods are static and can be overwritten in the overwritable-object
          */
         overwritable: {
             validatePassword: function(password) {
@@ -46,7 +46,7 @@ const myPlugin = {
          */
         hooks: {
             /**
-             * add a foo-property to each document. You can then call myDocument.foo (='bar')
+             * add a `foo` property to each document. You can then call myDocument.foo (='bar')
              */
             createRxDocument: {
                 /**
@@ -68,19 +68,19 @@ addRxPlugin(myPlugin);
 
 ## rxdb
 
-The `rxdb`-property signals that this plugin is and rxdb-plugin and not a pouchdb-plugin. The value should always be `true`.
+The `rxdb`-property signals that this plugin is an rxdb-plugin and not a pouchdb-plugin. The value should always be `true`.
 
 ## prototypes
 
-The `prototypes`-property contains a function for each of RxDB's internal prototype that you want to manipulate. Each function gets the prototype-object of the corresponding class as parameter and than can modify it. You can see a list of all available prototypes [here](https://github.com/pubkey/rxdb/blob/master/src/plugin.ts)
+The `prototypes`-property contains a function for each of RxDB's internal prototype that you want to manipulate. Each function gets the prototype-object of the corresponding class as parameter and then can modify it. You can see a list of all available prototypes [here](https://github.com/pubkey/rxdb/blob/master/src/plugin.ts)
 
 ## overwritable
 
-Some of RxDB's functions are not inside of a class-prototype but are static. You can set and overwrite them with the `overwritable`-object. You can see a list of all overwriteables [here](https://github.com/pubkey/rxdb/blob/master/src/overwritable.ts).
+Some of RxDB's functions are not inside of a class-prototype but are static. You can set and overwrite them with the `overwritable`-object. You can see a list of all overwritables [here](https://github.com/pubkey/rxdb/blob/master/src/overwritable.ts).
 
 # hooks
 
-Sometimes you don't want to overwrite an existing RxDB-method, but extend it. You can do this by adding hooks which will be called each time the code jumps into the hooks corresponding call. You can find a list of all hooks here [here](https://github.com/pubkey/rxdb/blob/master/src/hooks.ts).
+Sometimes you don't want to overwrite an existing RxDB-method, but extend it. You can do this by adding hooks which will be called each time the code jumps into the hooks corresponding call. You can find a list of all hooks [here](https://github.com/pubkey/rxdb/blob/master/src/hooks.ts).
 
 # options
 

orga/releases/12.0.0.md

@@ -202,9 +202,9 @@ Changes to `RxStorageInterface`:
 There are many things that can be done by **you** to improve RxDB:
 
 - Check the [BACKLOG](https://github.com/pubkey/rxdb/blob/master/orga/BACKLOG.md) for features that would be great to have.
-- Check the [breaking backlog](https://github.com/pubkey/rxdb/blob/master/orga/before-next-major.md) for breaking changes that must be implemented in the future but where I did not had the time yet.
+- Check the [breaking backlog](https://github.com/pubkey/rxdb/blob/master/orga/before-next-major.md) for breaking changes that must be implemented in the future but where I did not have the time yet.
 - Check the [TODOs](https://github.com/pubkey/rxdb/search?q=TODO) in the code. There are many small improvements that can be done for performance and build size.
-- Review the code and add tests. I am only a single human with a laptop. My code is not perfect and much small improvements can be done when people review the code and help me to clearify undefined behaviors.
+- Review the code and add tests. I am only a single human with a laptop. My code is not perfect and much small improvements can be done when people review the code and help me to clarify undefined behaviors.
 - Improve the documentation. In the last user survey, many users told me that the documentation is not good enough. But I reviewed the docs and could not find clear flaws. The problem is that I am way too deep into RxDB so that I am not able to understand which documentation a newcomer to the project needs. Likely I assume too much knowledge or focus writing about the wrong parts.
 - Update the [example projects](https://github.com/pubkey/rxdb/tree/master/examples) many of them are outdated and need updates.
 - Help the next [PouchDB release](https://github.com/pouchdb/pouchdb/issues/8408) to improve RxDBs performance.

src/overwritable.ts

@@ -1,8 +1,8 @@
 /**
  * functions that can or should be overwritten by plugins
- * IMPORTANT: Do not import any big stuff from RxDB here,
- * the 'overwritable' can be used inside of WebWorkers for the RxStorage only and
- * we do not want to have the full RxDB lib bundled in them.
+ * IMPORTANT: Do not import any big stuff from RxDB here!
+ * An 'overwritable' can be used inside WebWorkers for RxStorage only,
+ * and we do not want to have the full RxDB lib bundled in them.
  */
 
 import type { DeepReadonly } from './types/util';
@@ -12,7 +12,7 @@ import {
 
 export const overwritable = {
     /**
-     * if this method is overwritte with one
+     * if this method is overwritten with one
      * that returns true, we do additional checks
      * which help the developer but have bad performance
      */
@@ -22,8 +22,8 @@ export const overwritable = {
 
     /**
      * Deep freezes and object when in dev-mode.
-     * Deep-Freezing has the same performaance as deep-cloning, so we only do that in dev-mode.
-     * Also we can ensure the readonly state via typescript
+     * Deep-Freezing has the same performance as deep-cloning, so we only do that in dev-mode.
+     * Also, we can ensure the readonly state via typescript
      * @link https://developer.mozilla.org/de/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze
      */
     deepFreezeWhenDevMode<T>(obj: T): DeepReadonly<T> {
@@ -40,7 +40,7 @@ export const overwritable = {
     },
 
     /**
-     * overwritte to map error-codes to text-messages
+     * overwritten to map error-codes to text-messages
      */
     tunnelErrorMessage(message: string): string {
         return `RxDB Error-Code ${message}.