Merge pull request #530 from roipeker/docs

docs changes

@@ -81,7 +81,7 @@ import 'package:get/get.dart';
 The "counter" project created by default on new project on Flutter has over 100 lines (with comments). To show the power of Get, I will demonstrate how to make a "counter" changing the state with each click, switching between pages and sharing the state between screens, all in an organized way, separating the business logic from the view, in ONLY 26 LINES CODE INCLUDING COMMENTS.
 The "counter" project created by default on new project on Flutter has over 100 lines (with comments). To show the power of Get, I will demonstrate how to make a "counter" changing the state with each click, switching between pages and sharing the state between screens, all in an organized way, separating the business logic from the view, in ONLY 26 LINES CODE INCLUDING COMMENTS.
 
 
 - Step 1:
 - Step 1:
-Add "Get" before your materialApp, turning it into GetMaterialApp
+Add "Get" before your MaterialApp, turning it into GetMaterialApp
 
 
 ```dart
 ```dart
 void main() => runApp(GetMaterialApp(home: Home()));
 void main() => runApp(GetMaterialApp(home: Home()));
@@ -498,6 +498,43 @@ void localLogWriter(String text, {bool isError = false}) {
 
 
 ```
 ```
 
 
+### Local State Widgets
+
+These Widgets allows you to manage a single value, and keep the state ephemeral and locally.
+We have flavours for Reactive and Simple.
+For instance, you might use them to toggle obscureText in a TextField, maybe create a custom
+Expandable Panel, or maybe modify the current index in BottomNavigationBar while changing the content
+of the body in a Scaffold.
+
+#### ValueBuilder
+A simplification of StatefulWidget that works with a "setState" callback that takes the updated value.
+
+```dart
+ValueBuilder<bool>(
+  initialValue: false,
+  builder: (value, updateFn) => Switch(
+    value: value,
+    onChanged: updateFn, // same signature! you could use ( newValue ) => updateFn( newValue )
+  ),
+  // if you need to call something outside the builder method.
+  onUpdate: (value) => print("Value updated: $value"),
+  onDispose: () => print("Widget unmounted"),   
+),
+```
+
+#### ObxValue
+Similar to ValueBuilder, but this is the Reactive version, you pass a Rx instance (remember the magical .obs?) and 
+updates automatically... isn't it awesome?
+
+```dart
+ObxValue((data) => Switch(
+        value: data.value,
+        onChanged: data, // Rx has a _callable_ function! You could use (flag) => data.value = flag,
+    ),
+    false.obs,
+),
+```
+
 ## Video explanation of Other GetX Features
 ## Video explanation of Other GetX Features
 
 
 
 

@@ -11,7 +11,8 @@ typedef ValueBuilderBuilder<T> = Widget Function(
 
 
 /// Manages a local state like ObxValue, but uses a callback instead of a Rx value.
 /// Manages a local state like ObxValue, but uses a callback instead of a Rx value.
 ///
 ///
-/// Sample:
+/// Example:
+/// ```
 ///  ValueBuilder<bool>(
 ///  ValueBuilder<bool>(
 ///    initialValue: false,
 ///    initialValue: false,
 ///    builder: (value, update) => Switch(
 ///    builder: (value, update) => Switch(
@@ -21,6 +22,7 @@ typedef ValueBuilderBuilder<T> = Widget Function(
 ///    },),
 ///    },),
 ///    onUpdate: (value) => print("Value updated: $value"),
 ///    onUpdate: (value) => print("Value updated: $value"),
 ///  ),
 ///  ),
+///  ```
 class ValueBuilder<T> extends StatefulWidget {
 class ValueBuilder<T> extends StatefulWidget {
   final T initialValue;
   final T initialValue;
   final ValueBuilderBuilder builder;
   final ValueBuilderBuilder builder;