Merge pull request #33 from harness/MAINT-adding-readme-standards

Update Readme.md

Author: Dave Johnston

README.md

@@ -1,4 +1,4 @@
-Harness Feature Flag Python SDK
+Python SDK For Harness Feature Flags
 ========================
 
 [![pypi](https://img.shields.io/pypi/v/harness-featureflags.svg)](https://pypi.python.org/pypi/harness-featureflags)
@@ -13,10 +13,10 @@ Harness Feature Flag Python SDK
 
 ## Intro
 
-Harness Feature Flags (FF) is a feature management solution that enables users to change the software’s functionality, without deploying new code. FF uses feature flags to hide code or behaviours without having to ship new versions of the software. A feature flag is like a powerful if statement.
-* For more information, see https://harness.io/products/feature-flags/
-* To read more, see https://ngdocs.harness.io/category/vjolt35atg-feature-flags
-* To sign up, https://app.harness.io/auth/#/signup/
+Use this README to get started with our Feature Flags (FF) SDK for Python. This guide outlines the basics of getting started with the SDK and provides a full code sample for you to try out. 
+This sample doesn’t include configuration options, for in depth steps and configuring the SDK, for example, disabling streaming or using our Relay Proxy, see the  [Python SDK Reference](https://ngdocs.harness.io/article/hwoxb6x2oe-python-sdk-reference).
+
+For a sample FF Python SDK project, see our test [test Golang project](examples/getting_started/getting_started.py).
 
 ![FeatureFlags](https://github.com/harness/ff-python-server-sdk/raw/main/docs/images/ff-gui.png)
 
@@ -29,20 +29,22 @@ Harness Feature Flags (FF) is a feature management solution that enables users t
 
 
 ## Quickstart
-The Feature Flag SDK provides a client that connects to the feature flag service, and fetches the value
-of featue flags.   The following section provides an example of how to install the SDK and initalize it from
-an application.
-This quickstart assumes you have followed the instructions to [setup a Feature Flag project and have created a flag called `harnessappdemodarkmode` and created a server API Key](https://ngdocs.harness.io/article/1j7pdkqh7j-create-a-feature-flag#step_1_create_a_project).
+To follow along with our test code sample, make sure you’ve:
 
+- [Created a Feature Flag on the Harness Platform](https://ngdocs.harness.io/article/1j7pdkqh7j-create-a-feature-flag) called harnessappdemodarkmode
+- [Created a server SDK key and made a copy of it](https://ngdocs.harness.io/article/1j7pdkqh7j-create-a-feature-flag#step_3_create_an_sdk_key)
+- 
 ### Install the SDK
 Install the python SDK using pip
 ```python
 python -m pip install harness-featureflags
 ```
 
-### A Simple Example
-Here is a complete example that will connect to the feature flag service and report the flag value every 10 seconds until the connection is closed.  
-Any time a flag is toggled from the feature flag service you will receive the updated value.
+### Code Sample
+The following is a complete code example that you can use to test the `harnessappdemodarkmode` Flag you created on the Harness Platform. When you run the code it will:
+- Connect to the FF service.
+- Report the value of the Flag every 10 seconds until the connection is closed. Every time the harnessappdemodarkmode Flag is toggled on or off on the Harness Platform, the updated value is reported. 
+- Close the SDK.
 
 ```python
 from featureflags.client import CfClient
@@ -85,9 +87,9 @@ $ export FF_API_KEY=<your key here>
 $ python3 examples/getting_started/getting_started.py
 ```
 
-### Running with docker
+### Running the example with Docker
 If you dont have the right version of python installed locally, or dont want to install the dependancies you can
-use docker to quicky get started
+use docker to quickly get started
 
 ```bash
 # Install the package
@@ -99,13 +101,13 @@ docker run  -e PYTHONPATH=/app/local -e FF_API_KEY=$FF_API_KEY -v $(pwd):/app -w
 
 ### Additional Reading
 
-Further examples and config options are in the further reading section:
-
-[Further Reading](docs/further_reading.md)
+For further examples and config options, see the [Python SDK Reference](https://ngdocs.harness.io/article/hwoxb6x2oe-python-sdk-reference).
 
+For more information about Feature Flags, see our [Feature Flags documentation](https://ngdocs.harness.io/article/0a2u2ppp8s-getting-started-with-feature-flags).
 
 -------------------------
 [Harness](https://www.harness.io/) is a feature management platform that helps teams to build better software and to
 test features quicker.
 
 -------------------------
+

docs/further_reading.md

@@ -22,6 +22,7 @@ You can pass the configuration in as options when the SDK client is created.
 | pollInterval    | Config(pull_interval=60)                                 | when running in stream mode, the interval in seconds that we poll for changes.                                                                   | 60                                   |
 | enableStream    | with_stream_enabled(True),                               | Enable streaming mode.                                                                                                                           | true                                 |
 | enableAnalytics | with_analytics_enabled(True)                             | Enable analytics.  Metrics data is posted every 60s                                                                                              | true                                 |
+| pollInterval    | with_poll_interval(120)                                  | When running in stream mode, the interval in seconds that we poll for changes.                                                                   | 60                                   |
 
 ## Logging Configuration
 The SDK provides a logger that wraps the standard python logging package.  You can import and use it with: