Refactored the documentation.

Author: lucacillario

README.md

@@ -1,6 +1,6 @@
 # Redis Keyspace Notifications with Node-Redis
 
-This is a small project using Node.js ([Node-Redis](https://www.npmjs.com/package/redis) client), [Redis](https://redis.io) and Redis [Keyspace Notifications](https://redis.io/docs/manual/keyspace-notifications/).  Keyspace notifications allow clients to subscribe to [Pub/Sub](https://redis.io/docs/manual/pubsub/) channels in order to receive events affecting the Redis data set in some way.  In this project, we'll use them to model a high score table in a multi-player game.
+This is a small project using [Redis](https://redis.io) and Redis [Keyspace Notifications](https://redis.io/docs/manual/keyspace-notifications/).  Keyspace notifications allow clients to subscribe to [Pub/Sub](https://redis.io/docs/manual/pubsub/) channels in order to receive events affecting the Redis data set in some way.  In this project, we'll use them to model a high score table in a multi-player game.
 
 Imagine we're building a game in which players have to collect tokens, and where we measure who is winning by keeping track of how many tokens each player has.  We'll model this in Redis as follows:
 
@@ -13,17 +13,19 @@ Here's what this project looks like when running... in the left hand terminal I'
 
 ![demo](keyspace_events_demo.gif)
 
+
 ## Prerequisites
 
 To try out this project yourself, you'll need:
 
 * [Redis](https://redis.io) (install locally or use the supplied Docker Compose file).
 * [Docker Desktop](https://www.docker.com/products/docker-desktop/) (if using the Docker Compose file).
 * [git](https://git-scm.com/download) command line tools.
-* [Node.js](https://nodejs.org/) version 14.8 or higher.
+* [Node.js](https://nodejs.org/) version 14.8+ or [Python](https://www.python.org/) version 3.6+.
 
 If you're not familiar with how pub/sub works in Redis, you may want to read the [guide on redis.io](https://redis.io/docs/manual/pubsub/).
 
+
 ## Get the Code
 
 To get the code, clone the repo to your machine:
@@ -33,6 +35,7 @@ $ git clone https://github.com/redis-developer/keyspace-notifications-node-redis
 $ cd keyspace-notifications-node-redis
 ```
 
+
 ## Configuring and Starting Redis
 
 For performance reasons, keyspace notifications are off by default.  If you're using the supplied Docker Compose file, this will start a Redis Stack container and pass it [extra configuration settings](https://redis.io/docs/stack/get-started/install/docker/#environment-variables) that enable a subset of keyspace notifications that we need for our application.  If you go this route, there's nothing to do here - just start Redis Stack:
@@ -78,31 +81,13 @@ $ redis-cli
 
 See the [Keyspace Notifications configuration docs](https://redis.io/docs/manual/keyspace-notifications/#configuration) for more information on configuring events.
 
-## Application Setup
-
-To setup the application, first install the dependencies:
-
-```bash
-$ npm install
-```
-
-The application expects to find Redis at `localhost` on port `6379` with no password.  These are the default values when installing Redis.
 
-If your Redis server is located elsewhere and/or requires a password, set the value of the `REDIS_URL` environment variable to a valid [Redis connection URL](https://github.com/redis/node-redis#usage) before starting the application.  For example:
-
-```bash
-$ export REDIS_URL=redis://simon:sssssh@redis.mydomain.com:6390
-```
-
-## Running the Application
-
-Start the application as follows:
+## Application Setup
 
-```bash
-$ npm run dev
-```
+Check out the language-specific instructions:
+- [NodeJS](nodejs/README.md)
+- [Python](python/README.md)
 
-This uses [nodemon](https://www.npmjs.com/package/nodemon) which will restart the application for you automatically every time you make a code change.
 
 ## Generating Events
 
@@ -171,9 +156,11 @@ Scores:
 
 ## How does it Work?
 
+> We're gonna be using the Node.js implementation to describe how the application works. The same logic applies to all the examples, regardless of the language of choice.
+
 All of the code for this application is contained in a single file: `index.js`.
 
-The keyspace notification events are generated by Redis itself, so there's no code required to create these.  Instead our application needs to listen for them and take appropriate action.
+The keyspace notification events are generated by Redis itself, so there's no code required to create these. Instead our application needs to listen for them and take appropriate action.
 
 The [`PSUBSCRIBE`](https://redis.io/commands/psubscribe/) command is one of the ways that we can listen for pub/sub events.  The `P` in `PSUBSCRIBE` stands for "Pattern".  Redis publishes pub/sub events to named channels.  This command listens for events on pub/sub channels that match a glob style pattern.
 

nodejs/README.md

@@ -0,0 +1,26 @@
+## Application Setup
+
+To setup the application, first install the dependencies:
+
+```bash
+$ cd nodejs
+$ npm install
+```
+
+The application expects to find Redis at `localhost` on port `6379` with no password.  These are the default values when installing Redis.
+
+If your Redis server is located elsewhere and/or requires a password, set the value of the `REDIS_URL` environment variable to a valid [Redis connection URL](https://github.com/redis/node-redis#usage) before starting the application.  For example:
+
+```bash
+$ export REDIS_URL=redis://simon:sssssh@redis.mydomain.com:6390
+```
+
+## Running the Application
+
+Start the application as follows:
+
+```bash
+$ npm run dev
+```
+
+This uses [nodemon](https://www.npmjs.com/package/nodemon) which will restart the application for you automatically every time you make a code change.

python/README.md

@@ -0,0 +1,29 @@
+## Application Setup
+
+To setup the application, first install the dependencies:
+
+```bash
+$ cd python
+$ pip install -r requirements.txt
+```
+
+The application expects to find Redis at `localhost` on port `6379` with no password.  These are the default values when installing Redis.
+
+If your Redis server is located elsewhere and/or requires a password, set the value of the `REDIS_URL` environment variable to a valid [Redis connection URL](https://redis.readthedocs.io/en/stable/examples/connection_examples.html#Connecting-to-Redis-instances-by-specifying-a-URL-scheme.) before starting the application. For example:
+
+```bash
+$ export REDIS_URL=redis://luca:sssssh@redis.mydomain.com:6390
+```
+
+Finally, the default logging level is set to `INFO`. You can change it with the `LOGGING_LEVEL` environment variable. For example:
+```bash
+$ export LOGGING_LEVEL=DEBUG
+```
+
+## Running the Application
+
+Start the application as follows:
+
+```bash
+$ python main.py
+```