documentation: update documentation path pattern and add all *.md to lint checker (#2049)

* documentation: move to `documentation`

* documentation: update the README documentation links

* documentation: update the zh-cn README documentation links

* documentation: update the Readme documentation links

* documentation: change the README documentation links to local branch

* documentation: change the Promise-Wrapper links to local branch

* documentation: change the zh-cn README documentation links to local branch

* documentation: change the documentation Readme links to local branch

* documentation: update the Promise-Wrapper link

* documentation: update the documentation link to `en`

* fix: eslint markdown rules

* fix: check for README.md in `lint:docs` script

Author: wellwelwel

.eslintrc

@@ -46,6 +46,20 @@
         "prettier"
       ],
       "plugins": ["@typescript-eslint"]
+    },
+    {
+      "files":  ["**/*.md/*js"],
+      "rules": {
+        "no-undef": "off",
+        "no-unused-vars": "off",
+        "no-console": "off",
+        "no-unused-labels": "off",
+        "strict": "off",
+        "prefer-arrow-callback": "off"
+      },
+      "parserOptions": {
+        "sourceType": "module"
+      }
     }
   ]
 }

README.md

@@ -8,9 +8,9 @@
 [![Windows Build][appveyor-image]][appveyor-url]
 [![License][license-image]][license-url]  
 
-English | [简体中文](./documentation_zh-cn/)
+English | [简体中文](./documentation/zh-cn/)
 
-> MySQL client for Node.js with focus on performance. Supports prepared statements, non-utf8 encodings, binary log protocol, compression, ssl [much more](https://github.com/sidorares/node-mysql2/tree/master/documentation)
+> MySQL client for Node.js with focus on performance. Supports prepared statements, non-utf8 encodings, binary log protocol, compression, ssl [much more](./documentation/en)
 
 __Table of contents__
 
@@ -32,14 +32,14 @@ MySQL2 project is a continuation of [MySQL-Native][mysql-native]. Protocol parse
 MySQL2 is mostly API compatible with [mysqljs][node-mysql] and supports majority of features. MySQL2 also offers these additional features
 
  - Faster / Better Performance
- - [Prepared Statements](https://github.com/sidorares/node-mysql2/tree/master/documentation/Prepared-Statements.md)
+ - [Prepared Statements](./documentation/en/Prepared-Statements.md)
  - MySQL Binary Log Protocol
- - [MySQL Server](https://github.com/sidorares/node-mysql2/tree/master/documentation/MySQL-Server.md)
+ - [MySQL Server](./documentation/en/MySQL-Server.md)
  - Extended support for Encoding and Collation
- - [Promise Wrapper](https://github.com/sidorares/node-mysql2/tree/master/documentation/Promise-Wrapper.md)
+ - [Promise Wrapper](./documentation/en/Promise-Wrapper.md)
  - Compression
- - SSL and [Authentication Switch](https://github.com/sidorares/node-mysql2/tree/master/documentation/Authentication-Switch.md)
- - [Custom Streams](https://github.com/sidorares/node-mysql2/tree/master/documentation/Extras.md)
+ - SSL and [Authentication Switch](./documentation/en/Authentication-Switch.md)
+ - [Custom Streams](./documentation/en/Extras.md)
  - [Pooling](#using-connection-pools)
 
 ## Installation
@@ -145,18 +145,18 @@ You can use the pool in the same way as connections (using `pool.query()` and `p
 ```js
 // For pool initialization, see above
 pool.query("SELECT field FROM atable", function(err, rows, fields) {
-   // Connection is automatically released when query resolves
+  // Connection is automatically released when query resolves
 })
 ```
 
 Alternatively, there is also the possibility of manually acquiring a connection from the pool and returning it later:
 ```js
 // For pool initialization, see above
 pool.getConnection(function(err, conn) {
-   // Do something with the connection
-   conn.query(/* ... */);
-   // Don't forget to release the connection when finished!
-   pool.releaseConnection(conn);
+  // Do something with the connection
+  conn.query(/* ... */);
+  // Don't forget to release the connection when finished!
+  pool.releaseConnection(conn);
 })
 ```
 
@@ -204,6 +204,7 @@ async function main() {
   const promisePool = pool.promise();
   // query database using promises
   const [rows,fields] = await promisePool.query("SELECT 1");
+}
 ```
 
 MySQL2 exposes a .promise() function on Connections, to "upgrade" an existing non-promise connection to use promise
@@ -258,7 +259,7 @@ If you find any other incompatibility with [Node MySQL][node-mysql], Please repo
 
 ## Documentation
 
-You can find more detailed documentation [here](https://github.com/sidorares/node-mysql2/tree/master/documentation). You should also check various code [examples](https://github.com/sidorares/node-mysql2/tree/master/examples) to understand advanced concepts.
+You can find more detailed documentation [here](./documentation/en). You should also check various code [examples](./examples) to understand advanced concepts.
 
 ## Acknowledgements
 

documentation/.eslintrc

@@ -57,4 +57,4 @@ co(function * () {
   yield c.end();
 });
 ```
-Examples in [/examples/promise-co-await](https://github.com/sidorares/node-mysql2/tree/master/examples/promise-co-await)
+Examples in [/examples/promise-co-await](../../examples/promise-co-await)

documentation/Authentication-Switch.md renamed to documentation/en/Authentication-Switch.md

@@ -8,19 +8,19 @@
 
 Not only `Node-MySQL2` offers better performance over `node-mysql`, we also support these additional features.
 
-- [Prepared Statements](https://github.com/sidorares/node-mysql2/tree/master/documentation/Prepared-Statements.md)
-- [Promise Wrapper](https://github.com/sidorares/node-mysql2/tree/master/documentation/Promise-Wrapper.md)
-- [Authentication Switch](https://github.com/sidorares/node-mysql2/tree/master/documentation/Authentication-Switch.md)
-- [More Features](https://github.com/sidorares/node-mysql2/tree/master/documentation/Extras.md)
-- [MySQL Server](https://github.com/sidorares/node-mysql2/tree/master/documentation/MySQL-Server.md)
+- [Prepared Statements](./Prepared-Statements.md)
+- [Promise Wrapper](./Promise-Wrapper.md)
+- [Authentication Switch](./Authentication-Switch.md)
+- [More Features](./Extras.md)
+- [MySQL Server](./MySQL-Server.md)
 - Pooling
 - SSL
 - MySQL Compression
 - Binary Log Protocol Client
 
 ## Examples
 
-Please check these [examples](https://github.com/sidorares/node-mysql2/tree/master/documentation/Examples.md) for `node-mysql2`.
+Please check these [examples](./Examples.md) for `node-mysql2`.
 
 
 ## Known incompatibilities with `node-mysql`
@@ -48,4 +48,4 @@ You need to check corresponding field's zeroFill flag and convert to string manu
   - https://gist.github.com/sidorares/ffe9ee9c423f763e3b6b
   - `npm run benchmarks`
   - [node-mysql-benchmarks](https://github.com/mscdex/node-mysql-benchmarks)
-  - try to run example [benchmarks](https://github.com/sidorares/node-mysql2/tree/master/benchmarks) on your system
+  - try to run example [benchmarks](../../benchmarks) on your system