diff --git a/README.md b/README.md
index 041d87f3..24d4116c 100644
--- a/README.md
+++ b/README.md
@@ -3,26 +3,17 @@
[](https://pypi.org/project/optimizely-sdk)
[](https://github.com/optimizely/python-sdk/actions/workflows/python.yml?query=branch%3Amaster)
[](https://coveralls.io/github/optimizely/python-sdk)
-[](https://optimizely-python-sdk.readthedocs.io/en/latest/?badge=latest)
[](http://www.apache.org/licenses/LICENSE-2.0)
-This repository houses the official Python SDK for use with Optimizely
-Full Stack and Optimizely Rollouts.
+This repository houses the Python SDK for use with Optimizely Feature Experimentation and Optimizely Full Stack (legacy).
-Optimizely Full Stack is A/B testing and feature flag management for
-product development teams. Experiment in any application. Make every
-feature on your roadmap an opportunity to learn. Learn more at
-, or see the [Full
-Stack
-documentation](https://docs.developers.optimizely.com/full-stack/docs).
+Optimizely Feature Experimentation is an A/B testing and feature management tool for product development teams that enables you to experiment at every step. Using Optimizely Feature Experimentation allows for every feature on your roadmap to be an opportunity to discover hidden insights. Learn more at [Optimizely.com](https://www.optimizely.com/products/experiment/feature-experimentation/), or see the [developer documentation](https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/welcome).
-Optimizely Rollouts is free feature flags for development teams. Easily
-roll out and roll back features in any application without code deploys.
-Mitigate risk for every feature on your roadmap. Learn more at
-, or see the [Rollouts
-documentation](https://docs.developers.optimizely.com/rollouts/docs).
+Optimizely Rollouts is [free feature flags](https://www.optimizely.com/free-feature-flagging/) for development teams. You can easily roll out and roll back features in any application without code deploys, mitigating risk for every feature on your roadmap.
-## Getting Started
+## Get Started
+
+Refer to the [Python SDK's developer documentation](https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/python-sdk) for detailed instructions on getting started with using the SDK.
### Requirements
@@ -30,7 +21,7 @@ Version `4.0+`: Python 3.7+, PyPy 3.7+
Version `3.0+`: Python 2.7+, PyPy 3.4+
-### Installing the SDK
+### Install the SDK
The SDK is available through [PyPi](https://pypi.python.org/pypi?name=optimizely-sdk&:action=display).
@@ -41,9 +32,11 @@ To install:
### Feature Management Access
To access the Feature Management configuration in the Optimizely
-dashboard, please contact your Optimizely account executive.
+dashboard, please contact your Optimizely customer success manager.
+
+## Use the Python SDK
-### Using the SDK
+### Initialization
You can initialize the Optimizely instance in three ways: with a datafile, by providing an sdk_key, or by providing an implementation of
[BaseConfigManager](https://github.com/optimizely/python-sdk/tree/master/optimizely/config_manager.py#L32).
@@ -85,7 +78,7 @@ Each method is described below.
config_manager=custom_config_manager
)
-#### PollingConfigManager
+### PollingConfigManager
The [PollingConfigManager](https://github.com/optimizely/python-sdk/blob/master/optimizely/config_manager.py#L150) asynchronously polls for
datafiles from a specified URL at regular intervals by making HTTP requests.
@@ -126,7 +119,7 @@ used to form the target URL.
You may also provide your own logger, error_handler, or
notification_center.
-#### AuthDatafilePollingConfigManager
+### AuthDatafilePollingConfigManager
The [AuthDatafilePollingConfigManager](https://github.com/optimizely/python-sdk/blob/master/optimizely/config_manager.py#L375)
implements `PollingConfigManager` and asynchronously polls for authenticated datafiles from a specified URL at regular intervals
@@ -143,7 +136,7 @@ your project and generate an access token for your datafile.
**datafile_access_token** The datafile_access_token is attached to the outbound HTTP request header to authorize the request and fetch the datafile.
-#### Advanced configuration
+### Advanced configuration
The following properties can be set to override the default
configurations for [PollingConfigManager](#pollingconfigmanager) and [AuthDatafilePollingConfigManager](#authdatafilepollingconfigmanager).
@@ -164,10 +157,10 @@ notifications, use:
notification_center.add_notification_listener(NotificationTypes.OPTIMIZELY_CONFIG_UPDATE, update_callback)
```
-For Further details see the Optimizely [Full Stack documentation](https://docs.developers.optimizely.com/full-stack/docs)
+For Further details see the Optimizely [Feature Experimentation documentation](https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/welcome)
to learn how to set up your first Python project and use the SDK.
-## Development
+## SDK Development
### Building the SDK
@@ -175,7 +168,7 @@ Build and install the SDK with pip, using the following command:
pip install -e .
-### Unit tests
+### Unit Tests
#### Running all tests
@@ -226,9 +219,40 @@ would be:
Please see [CONTRIBUTING](https://github.com/optimizely/python-sdk/blob/master/CONTRIBUTING.md).
-### Additional Code
-This software incorporates code from the following open source repos:
-requests (Apache-2.0 License: https://github.com/psf/requests/blob/master/LICENSE)
-pyOpenSSL (Apache-2.0 License https://github.com/pyca/pyopenssl/blob/main/LICENSE)
-cryptography (Apache-2.0 https://github.com/pyca/cryptography/blob/main/LICENSE.APACHE)
-idna (BSD 3-Clause License https://github.com/kjd/idna/blob/master/LICENSE.md)
+### Credits
+
+This software incorporates code from the following open source projects:
+
+requests (Apache-2.0 License: https://github.com/psf/requests/blob/master/LICENSE)
+
+pyOpenSSL (Apache-2.0 License https://github.com/pyca/pyopenssl/blob/main/LICENSE)
+
+cryptography (Apache-2.0 https://github.com/pyca/cryptography/blob/main/LICENSE.APACHE)
+
+idna (BSD 3-Clause License https://github.com/kjd/idna/blob/master/LICENSE.md)
+
+### Other Optimizely SDKs
+
+- Agent - https://github.com/optimizely/agent
+
+- Android - https://github.com/optimizely/android-sdk
+
+- C# - https://github.com/optimizely/csharp-sdk
+
+- Flutter - https://github.com/optimizely/optimizely-flutter-sdk
+
+- Go - https://github.com/optimizely/go-sdk
+
+- Java - https://github.com/optimizely/java-sdk
+
+- JavaScript - https://github.com/optimizely/javascript-sdk
+
+- PHP - https://github.com/optimizely/php-sdk
+
+- Python - https://github.com/optimizely/python-sdk
+
+- React - https://github.com/optimizely/react-sdk
+
+- Ruby - https://github.com/optimizely/ruby-sdk
+
+- Swift - https://github.com/optimizely/swift-sdk
diff --git a/setup.py b/setup.py
index d40a23b6..5e2ccc2e 100644
--- a/setup.py
+++ b/setup.py
@@ -24,16 +24,17 @@
CHANGELOG = _file.read()
about_text = (
- 'Optimizely X Full Stack is A/B testing and feature management for product development teams. '
+ 'Optimizely Feature Experimentation is A/B testing and feature management for product development teams. '
'Experiment in any application. Make every feature on your roadmap an opportunity to learn. '
- 'Learn more at https://www.optimizely.com/products/full-stack/ or see our documentation at '
- 'https://docs.developers.optimizely.com/full-stack/docs. '
+ 'Learn more at https://www.optimizely.com/products/experiment/feature-experimentation/ or see our documentation at '
+ 'https://docs.developers.optimizely.com/experimentation/v4.0.0-full-stack/docs/welcome. '
)
setup(
name='optimizely-sdk',
version=__version__,
- description='Python SDK for Optimizely X Full Stack.',
+ description='Python SDK for Optimizely Feature Experimentation, Optimizely Full Stack (legacy), '
+ 'and Optimizely Rollouts.',
long_description=about_text + README + CHANGELOG,
long_description_content_type='text/markdown',
author='Optimizely',