From be4ca540f6466e3545ab5807d55ab0f3f8da6cad Mon Sep 17 00:00:00 2001
From: Zaid <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 16:44:24 -0500
Subject: [PATCH 01/26] Update README.md

---
 README.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 17216fa..7a6a279 100644
--- a/README.md
+++ b/README.md
@@ -9,20 +9,20 @@ cordis is a fully modular, micro-service based [Node.js](https://nodejs.org/) wr
 
 It is cut up in multiple packages/libraries:
 
-- `@cordis/bitfield`, for working with bitfields using BigInts
-- `@cordis/brokers`, message brokers for routing patterns, pub/sub systems and RPC!
-- `@cordis/common`, cordis core utilities
-- `@cordis/gateway`, containing a very flexible way of connecting to Discord's gateway - with clustering support
-- `@cordis/queue`, simple, small sequential queue for async operations
-- `@cordis/redis-store`, Redis implementation of `@cordis/store`
-- `@cordis/rest`, tooling for making HTTP requests to Discord, with rate limiting handling
-- `@cordis/routers`, make API requests with ease using simple dynamic javascript property accessing
-- `@cordis/snowflake`, simple snowflake structure for destructuring Discord IDs into relevant information
-- `@cordis/store`, Simple map-like interface for holding key-value pairs - ships with an in-memory implementation
+- [`@cordis/bitfield`](https://github.com/cordis-lib/cordis/tree/main/libs/bitfield), for working with bitfields using BigInts
+- [`@cordis/brokers`](https://github.com/cordis-lib/cordis/tree/main/libs/brokers), message brokers for routing patterns, pub/sub systems and RPC!
+- [`@cordis/common`](https://github.com/cordis-lib/cordis/tree/main/libs/common), cordis core utilities
+- [`@cordis/gateway`](https://github.com/cordis-lib/cordis/tree/main/libs/gateway), containing a very flexible way of connecting to Discord's gateway - with clustering support
+- [`@cordis/queue`](https://github.com/cordis-lib/cordis/tree/main/libs/queue), simple, small sequential queue for async operations
+- [`@cordis/redis-store`](https://github.com/cordis-lib/cordis/tree/main/libs/redis-store), Redis implementation of `@cordis/store`
+- [`@cordis/rest`](https://github.com/cordis-lib/cordis/tree/main/libs/rest), tooling for making HTTP requests to Discord, with rate limiting handling
+- [`@cordis/routers`](https://github.com/cordis-lib/cordis/tree/main/libs/routers), make API requests with ease using simple dynamic javascript property accessing
+- [`@cordis/snowflake`](https://github.com/cordis-lib/cordis/tree/main/libs/snowflake), simple snowflake structure for destructuring Discord IDs into relevant information
+- [`@cordis/store`](https://github.com/cordis-lib/cordis/tree/main/libs/store), Simple map-like interface for holding key-value pairs - ships with an in-memory implementation
 
 But also services that hook into RabbitMQ using the libraries mentioned above:
 
-- `@cordis/gateway-service` - https://hub.docker.com/r/cordislib/gateway
+- [`@cordis/gateway-service`](https://github.com/cordis-lib/cordis/tree/main/services/gateway) - https://hub.docker.com/r/cordislib/gateway
 
 
 # Come talk to me on Discord!

From c0e65afb7f44aa2e828a045abc1866d4f64572b6 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:26:55 -0500
Subject: [PATCH 02/26] add new cordis logo

---
 media/cordis_transparent.png | Bin 0 -> 94632 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 media/cordis_transparent.png

diff --git a/media/cordis_transparent.png b/media/cordis_transparent.png
new file mode 100644
index 0000000000000000000000000000000000000000..f0b33f6c411a128932e74ebf4e265c173fa421ad
GIT binary patch
literal 94632
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

literal 0
HcmV?d00001


From 42a46f7bb8b1e00051cc9badad35e1ea9439abab Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:27:04 -0500
Subject: [PATCH 03/26] pretty the root readme

---
 README.md | 58 +++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 39 insertions(+), 19 deletions(-)

diff --git a/README.md b/README.md
index 7a6a279..7e8cf77 100644
--- a/README.md
+++ b/README.md
@@ -1,30 +1,50 @@
 <div align="center">
-  <br/>
+  <img width="400" height="400" src="media/cordis_transparent.png">
+  <h4>
+    A fully modular, micro-service based <a href="https://nodejs.org/">Node.js</a> wrapper around the <a href="https://discordapp.com/developers/docs/intro">Discord API</a>
+  </h3>
+
   <p align="center">
-    <img width="190" height="190" src="media/cordis_no_letters_black.png">
+    <br />
+    <h3>
+      <strong>
+        <a href="https://cordis.didinele.me/">Explore the docs »</a><a href="https://discord.gg/37ysd5dPYk"> Join Our Discord!</a>
+      </strong>
+    </h2>
+  </p>  
+
+  <p>
+      <img src="https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg" alt="Linting">
+      <img src="https://github.com/cordis-lib/cordis/actions/workflows/docs.yml/badge.svg" alt="TypeScript"><br>
+      <a href="https://github.com/cordis-lib/cordis/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-yellow.svg" alt="License: APACHE 2.0"></a>
+      <a href="https://github.com/cordis-lib/cordis/issues"><img src="https://img.shields.io/github/issues-raw/cordis-lib/cordis.svg?maxAge=25000" alt="Issues"></a>
+      <a href="https://github.com/cordis-lib/cordis/pulls"><img src="https://img.shields.io/github/issues-pr/cordis-lib/cordis.svg?style=flat" alt="GitHub pull requests"></a><br>
+  </p>
 </div>
 
-# About
-cordis is a fully modular, micro-service based [Node.js](https://nodejs.org/) wrapper around the [Discord API](https://discordapp.com/developers/docs/intro)
+# Packages
 
-It is cut up in multiple packages/libraries:
+Cordis is cut up in the form of multiple packages/libraries:
 
-- [`@cordis/bitfield`](https://github.com/cordis-lib/cordis/tree/main/libs/bitfield), for working with bitfields using BigInts
-- [`@cordis/brokers`](https://github.com/cordis-lib/cordis/tree/main/libs/brokers), message brokers for routing patterns, pub/sub systems and RPC!
-- [`@cordis/common`](https://github.com/cordis-lib/cordis/tree/main/libs/common), cordis core utilities
-- [`@cordis/gateway`](https://github.com/cordis-lib/cordis/tree/main/libs/gateway), containing a very flexible way of connecting to Discord's gateway - with clustering support
-- [`@cordis/queue`](https://github.com/cordis-lib/cordis/tree/main/libs/queue), simple, small sequential queue for async operations
-- [`@cordis/redis-store`](https://github.com/cordis-lib/cordis/tree/main/libs/redis-store), Redis implementation of `@cordis/store`
-- [`@cordis/rest`](https://github.com/cordis-lib/cordis/tree/main/libs/rest), tooling for making HTTP requests to Discord, with rate limiting handling
-- [`@cordis/routers`](https://github.com/cordis-lib/cordis/tree/main/libs/routers), make API requests with ease using simple dynamic javascript property accessing
-- [`@cordis/snowflake`](https://github.com/cordis-lib/cordis/tree/main/libs/snowflake), simple snowflake structure for destructuring Discord IDs into relevant information
-- [`@cordis/store`](https://github.com/cordis-lib/cordis/tree/main/libs/store), Simple map-like interface for holding key-value pairs - ships with an in-memory implementation
+- [`@cordis/bitfield`](https://github.com/cordis-lib/cordis/tree/main/libs/bitfield) - A simple structure for working with bitfields using BigInts
+- [`@cordis/brokers`](https://github.com/cordis-lib/cordis/tree/main/libs/brokers) - Message brokers for routing patterns, pub/sub systems and RPC!
+- [`@cordis/common`](https://github.com/cordis-lib/cordis/tree/main/libs/common) - Common structures and utility shared across packages.
+- [`@cordis/gateway`](https://github.com/cordis-lib/cordis/tree/main/libs/gateway) - A very flexible way of connecting to Discord's gateway, with clustering support.
+  - [`@cordis/gateway-service`](https://github.com/cordis-lib/cordis/tree/main/services/gateway) ([Docker](https://hub.docker.com/r/cordislib/gateway)) - Service that hooks into RabbitMQ using `@cordis/gateway`
+- [`@cordis/queue`](https://github.com/cordis-lib/cordis/tree/main/libs/queue) - A simple and compact sequential queue for async operations
+- [`@cordis/redis-store`](https://github.com/cordis-lib/cordis/tree/main/libs/redis-store) - A Redis implementation of `@cordis/store`
+- [`@cordis/rest`](https://github.com/cordis-lib/cordis/tree/main/libs/rest) - Tooling for making HTTP requests to Discord, with rate limiting handling
+- [`@cordis/routers`](https://github.com/cordis-lib/cordis/tree/main/libs/routers) - Make API requests with ease using simple dynamic JavaScript property accessing
+- [`@cordis/snowflake`](https://github.com/cordis-lib/cordis/tree/main/libs/snowflake) - A simple snowflake structure for destructuring Discord IDs into relevant information
+- [`@cordis/store`](https://github.com/cordis-lib/cordis/tree/main/libs/store) - A simple map-like interface for holding key-value pairs - ships with an in-memory implementation
 
-But also services that hook into RabbitMQ using the libraries mentioned above:
+# Contributing
+We make use of [`PNPM`](https://pnpm.js.org/) to manage our monorepo setup. It is expected that you have an up-to-date version of it.
 
-- [`@cordis/gateway-service`](https://github.com/cordis-lib/cordis/tree/main/services/gateway) - https://hub.docker.com/r/cordislib/gateway
+Please ensure that you follow our [Code Of Conduct](https://github.com/discordjs/discord.js/blob/master/.github/CODE_OF_CONDUCT.md).
 
+# LICENSING
 
-# Come talk to me on Discord!
+© 2020, [Didinele](https://github.com/didinele). Some rights reserved.
 
-**Permanent invite link**: https://discord.gg/37ysd5dPYk
+> Cordis is licensed under [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE)

From 0cd28b8b2f7a2d3f7f5ec91c1678af905f5a9090 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:33:45 -0500
Subject: [PATCH 04/26] fix some alt tags

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7e8cf77..0722410 100644
--- a/README.md
+++ b/README.md
@@ -14,8 +14,8 @@
   </p>  
 
   <p>
-      <img src="https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg" alt="Linting">
-      <img src="https://github.com/cordis-lib/cordis/actions/workflows/docs.yml/badge.svg" alt="TypeScript"><br>
+      <img src="https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg" alt="Quality Check">
+      <img src="https://github.com/cordis-lib/cordis/actions/workflows/docs.yml/badge.svg" alt="Deploy Docs"><br>
       <a href="https://github.com/cordis-lib/cordis/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-yellow.svg" alt="License: APACHE 2.0"></a>
       <a href="https://github.com/cordis-lib/cordis/issues"><img src="https://img.shields.io/github/issues-raw/cordis-lib/cordis.svg?maxAge=25000" alt="Issues"></a>
       <a href="https://github.com/cordis-lib/cordis/pulls"><img src="https://img.shields.io/github/issues-pr/cordis-lib/cordis.svg?style=flat" alt="GitHub pull requests"></a><br>

From 7bdb620e0a7623a66f11cb16a8889f753324ab4f Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:33:52 -0500
Subject: [PATCH 05/26] bitfield readme

---
 libs/bitfield/README.md | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/libs/bitfield/README.md b/libs/bitfield/README.md
index 547e326..3dac1e6 100644
--- a/libs/bitfield/README.md
+++ b/libs/bitfield/README.md
@@ -1,12 +1,21 @@
-<div align = "center">
+# `@cordis/bitfield`  
 
-# @cordis/bitfield
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/bitfield?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/bitfield)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
-</div>
+Data structure for working with bitfields.
 
-## Description
-
-Data structure for working with bit fields.
+## Installation
+- `npm install @cordis/bitfield` 
+- `pnpm install @cordis/bitfield` 
+- `yarn add @cordis/bitfield`
 
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From c76b1b44dd7b21b2ce2f5b9307eae39c381bb68e Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:34:31 -0500
Subject: [PATCH 06/26] brokers readme

---
 libs/brokers/README.md | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/libs/brokers/README.md b/libs/brokers/README.md
index a89741c..4371a10 100644
--- a/libs/brokers/README.md
+++ b/libs/brokers/README.md
@@ -1,11 +1,21 @@
-<div align = "center">
+# `@cordis/brokers`  
 
-# @cordis/brokers
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/brokers?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/brokers)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
-</div>
+A library containing message brokers for all sorts of patterns & protocols
 
-## Description
-A library containing message brokers for all sorts of patterns & protocols.
+## Installation
+- `npm install @cordis/brokers` 
+- `pnpm install @cordis/brokers` 
+- `yarn add @cordis/brokers`
 
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From d782820d08905733977f9e01fd99e76c62ae91a8 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:41:07 -0500
Subject: [PATCH 07/26] pretty common readme

---
 libs/common/README.md | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/libs/common/README.md b/libs/common/README.md
index 31feb7f..3adeaad 100644
--- a/libs/common/README.md
+++ b/libs/common/README.md
@@ -1,12 +1,21 @@
-<div align = "center">
+# `@cordis/common`  
 
-# @cordis/common
-
-</div>
-
-## Description
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/common?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/common)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
 A library containing cordis utility functions/types/structures.
 
+## Installation
+- `npm install @cordis/common` 
+- `pnpm install @cordis/common` 
+- `yarn add @cordis/common`
+
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From c6c9d4e91c92eae0bbaeb71bd33c8ed2987dae4b Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:41:13 -0500
Subject: [PATCH 08/26] pretty error readme

---
 libs/error/README.md | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/libs/error/README.md b/libs/error/README.md
index 351e288..78738cc 100644
--- a/libs/error/README.md
+++ b/libs/error/README.md
@@ -1,12 +1,21 @@
-<div align = "center">
+# `@cordis/error`  
 
-# @cordis/error
-
-</div>
-
-## Description
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/error?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/error)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
 A library for easily creating error classes with pre-defined messages.
 
+## Installation
+- `npm install @cordis/error` 
+- `pnpm install @cordis/error` 
+- `yarn add @cordis/error`
+
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From 146f93d58a257758797c1fcd2d2a07ba5f3c0ae6 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:41:20 -0500
Subject: [PATCH 09/26] pretty gateway readme

---
 libs/gateway/README.md | 26 +++++++++++++++++---------
 1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/libs/gateway/README.md b/libs/gateway/README.md
index 9ac115f..6794c8d 100644
--- a/libs/gateway/README.md
+++ b/libs/gateway/README.md
@@ -1,15 +1,18 @@
-<div align = "center">
+# `@cordis/gateway`  
 
-# @cordis/gateway
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/gateway?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/gateway)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
-</div>
+The cordis WS client for Discord's API.
 
-## Description
-The cordis WS client for Discord's API
-___
+## Installation
+- `npm install @cordis/gateway` 
+- `pnpm install @cordis/gateway` 
+- `yarn add @cordis/gateway`
 
-## Example usage
-```js
+## Example Usage
+```ts
 const { Cluster } = require('@cordis/gateway');
 
 const main = async () => {
@@ -33,7 +36,12 @@ const main = async () => {
 
 main();
 ```
-___
 
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From d29b87a626966c2a63ba2652bffbbe5bd1f25ecc Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:41:33 -0500
Subject: [PATCH 10/26] pretty queue readme

---
 libs/queue/README.md | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/libs/queue/README.md b/libs/queue/README.md
index c2c00c4..d6c2ac3 100644
--- a/libs/queue/README.md
+++ b/libs/queue/README.md
@@ -1,12 +1,21 @@
-<div align = "center">
+# `@cordis/queue`  
 
-# @cordis/queue
-
-</div>
-
-## Description
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/queue?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/queue)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
 Simple and sequential queue for async operations.
 
+## Installation
+- `npm install @cordis/queue` 
+- `pnpm install @cordis/queue` 
+- `yarn add @cordis/queue`
+
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From 5acf61e01aee76d9913b175c3af5fec8f0ff853f Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:41:40 -0500
Subject: [PATCH 11/26] pretty redis-store readme

---
 libs/redis-store/README.md | 23 ++++++++++++++++-------
 1 file changed, 16 insertions(+), 7 deletions(-)

diff --git a/libs/redis-store/README.md b/libs/redis-store/README.md
index 1015feb..3f0e804 100644
--- a/libs/redis-store/README.md
+++ b/libs/redis-store/README.md
@@ -1,14 +1,23 @@
-<div align = "center">
+# `@cordis/redis-store`  
 
-# @cordis/redis-store
-
-</div>
-
-## Description
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/redis-store?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/redis-store)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
 Simple data structure for holding key-value pairs, taking from both Maps and Arrays.
 
-This package implements `@cordis/store` using Redis hashes.
+This package implements [`@cordis/store`](https://github.com/cordis-lib/cordis/tree/main/libs/store) using Redis hashes.
+
+## Installation
+- `npm install @cordis/redis-store` 
+- `pnpm install @cordis/redis-store` 
+- `yarn add @cordis/redis-store`
 
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From 72c8cf446ed8b87c48bbd45c4d7bf2a58243a7f7 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:41:48 -0500
Subject: [PATCH 12/26] pretty rest readme

---
 libs/rest/README.md | 26 +++++++++++++++++---------
 1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/libs/rest/README.md b/libs/rest/README.md
index b1bc093..0ba3afb 100644
--- a/libs/rest/README.md
+++ b/libs/rest/README.md
@@ -1,17 +1,20 @@
-<div align = "center">
+# `@cordis/rest`  
 
-# @cordis/rest
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/rest?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/rest)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
-</div>
-
-## Description
 Cordis' REST utilities for the Discord API
 
 Note: Props to https://github.com/spec-tacles/spectacles.js for the Mutex logic.
-___
 
-## Example usage
-```js
+## Installation
+- `npm install @cordis/rest` 
+- `pnpm install @cordis/rest` 
+- `yarn add @cordis/rest`
+
+## Example Usage
+```ts
 const { RestManager } = require('@cordis/rest');
 
 const main = async () => {
@@ -28,7 +31,12 @@ const main = async () => {
 
 main();
 ```
-___
 
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From a48d27fe4f838863d8d95a09886e632e7229bfad Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:41:56 -0500
Subject: [PATCH 13/26] pretty routers readme

---
 libs/routers/README.md | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/libs/routers/README.md b/libs/routers/README.md
index d2df220..020d1bd 100644
--- a/libs/routers/README.md
+++ b/libs/routers/README.md
@@ -1,16 +1,18 @@
-<div align = "center">
+# `@cordis/routers`  
 
-# @cordis/routers
-
-</div>
-
-## Description
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/routers?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/routers)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
 Construct API paths using simple JavaScript property accessing and execute requests with method calls.
 
-## Example
+## Installation
+- `npm install @cordis/routers` 
+- `pnpm install @cordis/routers` 
+- `yarn add @cordis/routers`
 
-```js
+## Example Usage
+```ts
 const { buildRestRouter } = require('@cordis/router');
 const { RestManager } = require('@cordis/rest');
 
@@ -23,3 +25,9 @@ console.log(user);
 
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From 8257cd26687a42d209c664b21bb544886ccc64ed Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:42:03 -0500
Subject: [PATCH 14/26] pretty snowflake readme

---
 libs/snowflake/README.md | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/libs/snowflake/README.md b/libs/snowflake/README.md
index b53eb53..7012f63 100644
--- a/libs/snowflake/README.md
+++ b/libs/snowflake/README.md
@@ -1,12 +1,21 @@
-<div align = "center">
+# `@cordis/snowflake`  
 
-# @cordis/snowflake
-
-</div>
-
-# Description
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/snowflake?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/snowflake)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
 Simple package for destructuring (Twitter) Discord snowflakes.
 
+## Installation
+- `npm install @cordis/snowflake` 
+- `pnpm install @cordis/snowflake` 
+- `yarn add @cordis/snowflake`
+
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From 7bde2b42178a5a71af3f106b89adda9edb055071 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:42:07 -0500
Subject: [PATCH 15/26] pretty store readme

---
 libs/store/README.md | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/libs/store/README.md b/libs/store/README.md
index 4dbf17d..adf2152 100644
--- a/libs/store/README.md
+++ b/libs/store/README.md
@@ -1,14 +1,23 @@
-<div align = "center">
+# `@cordis/store`  
 
-# @cordis/store
-
-</div>
-
-## Description
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/@cordis/store?color=crimson&logo=npm)](https://www.npmjs.com/package/@cordis/store)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
 Simple data structure for holding key-value pairs, taking from both Maps and Arrays.
 
 This package implements a simple in-memory store that actually extends the standard Map.
 
+## Installation
+- `npm install @cordis/store` 
+- `pnpm install @cordis/store` 
+- `yarn add @cordis/store`
+
 ## Documentation
 You can find documentation for the whole project over at https://cordis.didinele.me
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From 7583e697abc7378b19f89c0623b4b10d8b1df9e9 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 19:47:13 -0500
Subject: [PATCH 16/26] add code_of_conduct and additional info to root readme

---
 .github/CODE_OF_CONDUCT.md | 76 ++++++++++++++++++++++++++++++++++++++
 README.md                  |  6 ++-
 2 files changed, 81 insertions(+), 1 deletion(-)
 create mode 100644 .github/CODE_OF_CONDUCT.md

diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000..6bbfc6e
--- /dev/null
+++ b/.github/CODE_OF_CONDUCT.md
@@ -0,0 +1,76 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at https://discord.gg/bRCvFy9. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq
\ No newline at end of file
diff --git a/README.md b/README.md
index 0722410..23e9828 100644
--- a/README.md
+++ b/README.md
@@ -39,10 +39,14 @@ Cordis is cut up in the form of multiple packages/libraries:
 - [`@cordis/store`](https://github.com/cordis-lib/cordis/tree/main/libs/store) - A simple map-like interface for holding key-value pairs - ships with an in-memory implementation
 
 # Contributing
-We make use of [`PNPM`](https://pnpm.js.org/) to manage our monorepo setup. It is expected that you have an up-to-date version of it.
+We make use of [`PNPM`](https://pnpm.js.org/) to manage our monorepo setup. It is expected that you have an up-to-date version of it. 
+
+Please ensure you run `pnpm run lint` and `pnpm run build` in the root before pushing your commits.
 
 Please ensure that you follow our [Code Of Conduct](https://github.com/discordjs/discord.js/blob/master/.github/CODE_OF_CONDUCT.md).
 
+If all checks out, [Submit a Pull Request](https://github.com/cordis-lib/cordis/compare)
+
 # LICENSING
 
 © 2020, [Didinele](https://github.com/didinele). Some rights reserved.

From 680ae40fca042a4cb73c4cf6b3d6e78422af485f Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sat, 6 Mar 2021 20:07:49 -0500
Subject: [PATCH 17/26] add issue and pull request templates

---
 .github/ISSUE_TEMPLATE/bug_report.md      | 33 +++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml         |  5 ++++
 .github/ISSUE_TEMPLATE/feature_request.md | 22 +++++++++++++++
 .github/PULL_REQUEST_TEMPLATE.md          | 15 +++++++++++
 4 files changed, 75 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md
 create mode 100644 .github/PULL_REQUEST_TEMPLATE.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000..c2a60be
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,33 @@
+---
+
+name: Bug report
+about: Report incorrect or unexpected behavior of any cordis libraries/packages
+title: ''
+labels: 's: unverified, type: bug'
+assignees: ''
+---
+<!-- Thanks to Discord.js for this bug report template -->
+
+**Which cordis library/package are you facing this issue in?:**
+
+**Please describe the problem you are having in as much detail as possible:**
+
+**Include a reproducible code sample here, if possible:**
+
+```ts
+// Place your code here
+```
+
+**Further details:**
+
+- Cordis Package Version:
+- Node.js version:
+- Operating system:
+- Priority this issue should have – please be realistic and elaborate if possible:
+
+<!--
+Remove the comment and fill out the commit hash if this applies to you:
+(While it's not a requirement to test your issue on the master branch, it would make fixing the problem a lot easier for us, so please do so if possible.)
+
+- I have also tested the issue on latest master, commit hash: `xxx`
+-->
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..7441e54
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Discord server
+    url: https://discord.gg/37ysd5dPYk
+    about: Feel free to join our Discord server for any questions.
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 0000000..59e270a
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,22 @@
+---
+
+name: Feature request
+about: Request a feature for any of the cordis libraries/packages
+title: ''
+labels: 'type: enhancement'
+assignees: ''
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Eg. I'm always frustrated when [...]
+
+**Describe the ideal solution**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
+
+Adapted from the [Discord.js Feature Request Template](https://github.com/discordjs/discord.js/blob/master/.github/ISSUE_TEMPLATE/feature_request.md)
\ No newline at end of file
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..cd5719b
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,15 @@
+**Please describe the changes this PR makes and why it should be merged:**
+
+
+
+**Status and versioning classification:**
+
+<!--
+Please move lines that apply to you out of the comment:
+- Code changes have been tested against the Discord API, or there are no code changes
+- This PR changes the library's interface (methods or parameters added)
+- This PR includes breaking changes (methods removed or renamed, parameters moved or removed)
+- This PR **only** includes non-code changes, like changes to documentation, README, etc.
+
+Thanks to Discord.js for this pull request template.
+-->
\ No newline at end of file

From 74f55b0c902af6bcd05ad875c4f28bda634384a5 Mon Sep 17 00:00:00 2001
From: Zaid <me@zaid-arshad.tech>
Date: Sun, 7 Mar 2021 12:14:22 -0500
Subject: [PATCH 18/26] Update .github/ISSUE_TEMPLATE/bug_report.md

Co-authored-by: didinele <didinele.dev@gmail.com>
---
 .github/ISSUE_TEMPLATE/bug_report.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index c2a60be..2c945c8 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -8,7 +8,7 @@ assignees: ''
 ---
 <!-- Thanks to Discord.js for this bug report template -->
 
-**Which cordis library/package are you facing this issue in?:**
+**Which cordis libraries/services are you facing this issue in?:**
 
 **Please describe the problem you are having in as much detail as possible:**
 
@@ -30,4 +30,4 @@ Remove the comment and fill out the commit hash if this applies to you:
 (While it's not a requirement to test your issue on the master branch, it would make fixing the problem a lot easier for us, so please do so if possible.)
 
 - I have also tested the issue on latest master, commit hash: `xxx`
--->
\ No newline at end of file
+-->

From 8489053351b23be31d5e6822148f0c08a8e63195 Mon Sep 17 00:00:00 2001
From: Zaid <me@zaid-arshad.tech>
Date: Sun, 7 Mar 2021 12:15:24 -0500
Subject: [PATCH 19/26] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 23e9828..5426aca 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,6 @@ If all checks out, [Submit a Pull Request](https://github.com/cordis-lib/cordis/
 
 # LICENSING
 
-© 2020, [Didinele](https://github.com/didinele). Some rights reserved.
+© 2020, [didinele](https://github.com/didinele). Some rights reserved.
 
 > Cordis is licensed under [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE)

From c7a582b9a422865eb76f9e2ec4759ea7601e647a Mon Sep 17 00:00:00 2001
From: Zaid <me@zaid-arshad.tech>
Date: Sun, 7 Mar 2021 12:16:47 -0500
Subject: [PATCH 20/26] Update feature_request.md

---
 .github/ISSUE_TEMPLATE/feature_request.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
index 59e270a..a9a7b4a 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -1,7 +1,7 @@
 ---
 
 name: Feature request
-about: Request a feature for any of the cordis libraries/packages
+about: Request a feature for any of the cordis libraries/services
 title: ''
 labels: 'type: enhancement'
 assignees: ''
@@ -19,4 +19,4 @@ A clear and concise description of any alternative solutions or features you've
 **Additional context**
 Add any other context or screenshots about the feature request here.
 
-Adapted from the [Discord.js Feature Request Template](https://github.com/discordjs/discord.js/blob/master/.github/ISSUE_TEMPLATE/feature_request.md)
\ No newline at end of file
+Adapted from the [Discord.js Feature Request Template](https://github.com/discordjs/discord.js/blob/master/.github/ISSUE_TEMPLATE/feature_request.md)

From 31e577cc6ae651a12e2ad9a578099d182d719397 Mon Sep 17 00:00:00 2001
From: Zaid <me@zaid-arshad.tech>
Date: Sun, 7 Mar 2021 12:23:25 -0500
Subject: [PATCH 21/26] Update config.yml

---
 .github/ISSUE_TEMPLATE/config.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index 7441e54..8f160b4 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -2,4 +2,5 @@ blank_issues_enabled: false
 contact_links:
   - name: Discord server
     url: https://discord.gg/37ysd5dPYk
-    about: Feel free to join our Discord server for any questions.
\ No newline at end of file
+    about: Feel free to join our Discord server for any questions.
+

From e78c802df9c396b180b5d3d455ae4e44b2626620 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sun, 7 Mar 2021 12:46:12 -0500
Subject: [PATCH 22/26] resolve
 https://github.com/cordis-lib/cordis/pull/47#discussion_r589054822

---
 .github/ISSUE_TEMPLATE/bug_report.md | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 2c945c8..2c0fda5 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -20,7 +20,19 @@ assignees: ''
 
 **Further details:**
 
-- Cordis Package Version:
+<!-- Only keep and fill out what's applicable to you -->
+- `@cordis/gateway` version:
+- `@cordis/bitfield` version:
+- `@cordis/brokers` version:
+- `@cordis/common` version:
+- `@cordis/error` version:
+- `@cordis/queue` version:
+- `@cordis/redis-store` version:
+- `@cordis/store` version:
+- `@cordis/rest` version:
+- `@cordis/routers` version:
+- `@cordis/gateway` version:
+- `@cordis/snowflake` version:
 - Node.js version:
 - Operating system:
 - Priority this issue should have – please be realistic and elaborate if possible:

From d8d5ce487ca289e4c47de6ed8532cac6977a8f1a Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sun, 7 Mar 2021 13:04:50 -0500
Subject: [PATCH 23/26] remove extra EOL

---
 .github/ISSUE_TEMPLATE/config.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index 8f160b4..b0cd014 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -3,4 +3,3 @@ contact_links:
   - name: Discord server
     url: https://discord.gg/37ysd5dPYk
     about: Feel free to join our Discord server for any questions.
-

From a3988bacae82fb2b5e733b23f41c7cd15ca8e1f1 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sun, 7 Mar 2021 13:06:05 -0500
Subject: [PATCH 24/26] add all cordis packages/services to bug report

---
 .github/ISSUE_TEMPLATE/bug_report.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 2c0fda5..88304b3 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -20,7 +20,7 @@ assignees: ''
 
 **Further details:**
 
-<!-- Only keep and fill out what's applicable to you -->
+<!-- Only keep and fill out what's applicable to you
 - `@cordis/gateway` version:
 - `@cordis/bitfield` version:
 - `@cordis/brokers` version:
@@ -33,6 +33,8 @@ assignees: ''
 - `@cordis/routers` version:
 - `@cordis/gateway` version:
 - `@cordis/snowflake` version:
+- `@cordis/gateway-service` version:
+-->
 - Node.js version:
 - Operating system:
 - Priority this issue should have – please be realistic and elaborate if possible:

From 7512ba42b7f156bc59c433b212c9f762e26592d4 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sun, 7 Mar 2021 13:13:27 -0500
Subject: [PATCH 25/26] @cordis/gateway-service readme

---
 services/gateway/README.md | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/services/gateway/README.md b/services/gateway/README.md
index 274951d..88a1eaa 100644
--- a/services/gateway/README.md
+++ b/services/gateway/README.md
@@ -1,9 +1,15 @@
-<div align = "center">
+# `@cordis/gateway-service`  
 
-# Cordis gateway service
+[![GitHub](https://img.shields.io/badge/License-Apache%202.0-yellow.svg)](https://github.com/cordis-lib/cordis/blob/main/LICENSE)
+[![TypeScript](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml/badge.svg)](https://github.com/cordis-lib/cordis/actions/workflows/quality.yml)
 
-</div>
-
-## Description
 
 Docker service for the cordis gateway, respecting [the spec](https://github.com/cordis-lib/spec).
+
+You can find the image [here](https://hub.docker.com/r/cordislib/gateway)
+
+## Contributing
+Please see the main [README.md](https://github.com/cordis-lib/cordis) for info on how to contribute to this package or the other `@cordis` packages.
+
+## LICENSE
+Licensed under the [Apache 2.0](https://github.com/cordis-lib/cordis/blob/main/LICENSE) license.
\ No newline at end of file

From 33eb57d2e9ddfffe8bacc31acf8dd42bebe145b5 Mon Sep 17 00:00:00 2001
From: "Zaid \"Nico" <me@zaid-arshad.tech>
Date: Sun, 7 Mar 2021 13:14:23 -0500
Subject: [PATCH 26/26] mention unit tests in root readme

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5426aca..7b9eb0b 100644
--- a/README.md
+++ b/README.md
@@ -41,7 +41,7 @@ Cordis is cut up in the form of multiple packages/libraries:
 # Contributing
 We make use of [`PNPM`](https://pnpm.js.org/) to manage our monorepo setup. It is expected that you have an up-to-date version of it. 
 
-Please ensure you run `pnpm run lint` and `pnpm run build` in the root before pushing your commits.
+Please ensure you run `pnpm run lint`, `pnpm run build`, and `pnpm run test` in the root before pushing your commits.
 
 Please ensure that you follow our [Code Of Conduct](https://github.com/discordjs/discord.js/blob/master/.github/CODE_OF_CONDUCT.md).