[FSSDK-8962] Reorganize sample + other stuff

Author: mikechu-optimizely

README.md

@@ -41,43 +41,44 @@ Then run
 
 ## Use the Flutter SDK
 
-A sample code for SDK initialization:
+### Initialization
+
+Import the package in your application code:
 
 ```dart
-   var flutterSDK = OptimizelyFlutterSdk("my_sdk_key");
-   var response = await flutterSDK.initializeClient();
+   import 'package:optimizely_flutter_sdk/optimizely_flutter_sdk.dart';
 ```
 
-### Initialization
-
-Then, import the package in your application code:
+Instantiate the SDK, adding your SDK Key and initializing the client:
 
 ```dart
-   import 'package:optimizely_flutter_sdk/optimizely_flutter_sdk.dart';
+   var flutterSDK = OptimizelyFlutterSdk("your_sdk_key");
+   var response = await flutterSDK.initializeClient();
 ```
 
 ### Feature Rollouts
 ```dart
+   import 'package:optimizely_flutter_sdk/optimizely_flutter_sdk.dart';
+
    // Also supports eventOptions, datafilePeriodicDownloadInterval, datafileHostOptions and defaultDecideOptions
-   var flutterSDK = OptimizelyFlutterSdk("my_sdk_key");
+   var flutterSDK = OptimizelyFlutterSdk("your_sdk_key");
 
-   // instantiate a client
    var response = await flutterSDK.initializeClient();
 
    // User attributes are optional and used for targeting and results segmentation
    var attributes = {
       "state": "California",
       "likes_donuts": true
    };
-   var user = await flutterSDK.createUserContext("optimizely end user", attributes);
+   var user = await flutterSDK.createUserContext("user_id", attributes);
    var decideReponse = await user!.decide("binary_feature");
 ```
 
 ## SDK Development
 
 ### Unit Tests
 
-1. To run [unit tests](https://docs.flutter.dev/cookbook/testing/unit/introduction) using terminal, simply use the following command
+To run [unit tests](https://docs.flutter.dev/cookbook/testing/unit/introduction) using terminal, simply use the following command:
 
 ```bash
 flutter test test/optimizely_flutter_sdk_test.dart
@@ -87,7 +88,6 @@ flutter test test/optimizely_flutter_sdk_test.dart
 
 Please see [CONTRIBUTING](CONTRIBUTING.md).
 
-
 ### Other Optimizely SDKs
 
 - Agent - https://github.com/optimizely/agent