fix: Correct timeout handling in example. (#97)

Update the timeout handling in the example.

Also make a few minor documentation updates.

packages/flutter_client_sdk/example/lib/main.dart

@@ -93,7 +93,9 @@ class _MyHomePageState extends State<MyHomePage> {
           FutureBuilder(
               future: Provider.of<LDClient>(context, listen: false)
                   .start()
-                  .timeout(const Duration(seconds: 5))
+                  // In this case we do not have special handling for a failed
+                  // initialization or timeout.
+                  .timeout(const Duration(seconds: 5), onTimeout: () => true)
                   .then((value) => true),
               builder: (context, loaded) => loaded.data ?? false
                   ? Center(

packages/flutter_client_sdk/lib/src/ld_client.dart

@@ -9,17 +9,19 @@ import 'platform_env_reporter.dart';
 
 /// The main interface for the LaunchDarkly Flutter SDK.
 ///
-/// To setup the SDK before use, build an [LDConfig] with [LDConfigBuilder] and
+/// To setup the SDK before use, construct an [LDConfig] and
 /// an initial [LDContext] with [LDContextBuilder].
 /// These should be passed to [LDClient(config, context)] and then [start]
 /// should be called. A basic example:
 /// ```dart
+/// final config = LDConfig(CredentialSource.fromEnvironment(),
+///   AutoEnvAttributes.enabled);
 /// final context = LDContextBuilder()
 ///   .kind("user", <USER_KEY>)
 ///   .kind("company", <COMP_KEY>)
 ///   .build();
 /// final client = LDClient(config, context);
-/// await client.start();
+/// await client.start().timeout(const Duration(seconds: 5), onTimeout: () => false);
 /// ```
 ///
 /// After initialization, the SDK can evaluate feature flags from the
@@ -55,7 +57,9 @@ interface class LDClient {
     return _client.flagChanges;
   }
 
-  /// TODO: Comments
+  /// Construct the client instance.
+  ///
+  /// For detailed instructions please refer to the class [LDClient] documentation.
   LDClient(LDConfig config, LDContext context) {
     final platformImplementation = CommonPlatform(
         persistence: SharedPreferencesPersistence(),