update README and documentation (#101)

Author: mdumandag

docs/getting_started.rst

@@ -16,14 +16,13 @@ An even simpler way is to install the client from the official Python Package In
     pip install hazelcast-python-client
 
 
-
 Starting Hazelcast
 ------------------
 
-Before diving right into the configuration, you should have a running Hazelcast server. If you are already familiar
-with Hazelcast and have a server running, you can simply skip to the Configuration section.
+Before diving right into the configuration, you should have a running Hazelcast member. If you are already familiar
+with Hazelcast and have a member running, you can simply skip to the Configuration section.
 
-If not, follow these steps to start an Hazelcast server in your local computer:
+If not, follow these steps to start an Hazelcast member in your local computer:
 
 * Make sure that you have `Java <http://www.oracle.com/technetwork/java/javase/downloads/index.html>`_ installed on your system.
 * Download the latest `Hazelcast release <https://hazelcast.org/download/>`_.
@@ -32,7 +31,9 @@ If not, follow these steps to start an Hazelcast server in your local computer:
 * If you are using Linux/MacOS, you can start a Hazelcast member with **start.sh** and stop the member you have started with **stop.sh** when you are done.
 * If you are using Windows, you can start a Hazelcast member with **start.bat** and stop the member you have started with **stop.bat** when you are done.
 * Refer to the `Using the Scripts In The Package <http://docs.hazelcast.org/docs/latest/manual/html-single/index.html#using-the-scripts-in-the-package>`_ for more information about these scripts.
-* After successfully running these scripts, you should see the ip address and port of your member on your console. Take a note of these and jump right into the Configuration section!
+* If you use **start.sh/bat** again while your first Hazelcast member is running, you will start a second Hazelcast member. These members will join together to form a Hazelcast cluster.
+* You can increase the size of your cluster by repeating the step above as many times as you want.
+* After successfully running these scripts, you should see the ip address and port of your members on your console. Take a note of these and jump right into the Configuration section!
 
 
 Configuration

examples/README.md

@@ -6,17 +6,19 @@ This folder contains a collection of code samples which you can use to learn how
 How to try these examples
 -------------------------
 
-* To try these examples, you should have a running Hazelcast server. If you are already familiar with Hazelcast and have a server running, add its address and port to your configuration as shown in the [**/learning-basics/1-configure_client.py**](learning-basics/1-configure_client.py).
-* If not, follow these steps to start an Hazelcast server in your local computer:
+* To try these examples, you should have a running Hazelcast member. If you are already familiar with Hazelcast and have a member running, add its address and port to your configuration as shown in the [**/learning-basics/1-configure_client.py**](learning-basics/1-configure_client.py).
+* If not, follow these steps to start an Hazelcast member in your local computer:
     * Make sure that you have [Java](http://www.oracle.com/technetwork/java/javase/downloads/index.html) installed on your system.
     * Download the latest [Hazelcast release](https://hazelcast.org/download/).
     * Extract the zip file you have downloaded.
     * You should see a directory called **bin** which includes a few scripts and xml files.
     * If you are using Linux/MacOS, you can start a Hazelcast member with **start.sh** and stop the member you have started with **stop.sh** when you are done.
     * If you are using Windows, you can start a Hazelcast member with **start.bat** and stop the member you have started with **stop.bat** when you are done.
     * Refer to the [Using the Scripts In The Package](http://docs.hazelcast.org/docs/latest/manual/html-single/index.html#using-the-scripts-in-the-package) for more information about these scripts.
-    * After successfully running these scripts, you should see the ip address and port of your member on your console. Take a note of these.
-    * Add this address and port to your configuration as shown in the [**/learning-basics/1-configure_client.py**](learning-basics/1-configure_client.py). 
+    * If you use **start.sh/bat** again while your first Hazelcast member is running, you will start a second Hazelcast member. These members will join together to form a Hazelcast cluster.
+    * You can increase the size of your cluster by repeating the step above as many times as you want.
+    * After successfully running these scripts, you should see the ip address and port of your members on your console. Take a note of these.
+    * Add these addresses and ports to your configuration as shown in the [**/learning-basics/1-configure_client.py**](learning-basics/1-configure_client.py). 
 * After configuring your client as described above, you are ready to learn using Hazelcast Python Client with these examples.
 
 Included example folders

examples/learning-basics/1-configure_client.py

@@ -10,8 +10,10 @@
     config = hazelcast.ClientConfig()
     print("Cluster name: {}".format(config.group_config.name))
 
-    # Add server's host:port to the configuration
+    # Add member's host:port to the configuration.
+    # For each member on your Hazelcast cluster, you should add its host:port pair to the configuration.
     config.network_config.addresses.append("127.0.0.1:5701")
+    config.network_config.addresses.append("127.0.0.1:5702")
 
     # Create a client using the configuration above
     client = hazelcast.HazelcastClient(config)