docs (reordered sections and typo fix)

Author: dakujem

readme.md

@@ -5,7 +5,7 @@
 
 SelectBox & MultiSelectBox hybrid input with lazy & asynchronous options loading capabilities to be used with Select2, Selectize, Chosen and similar UI libraries.
 
-The aim of Slectoo is to provide a flexible tool for creating reusable select inputs.
+The aim of Selectoo is to provide a flexible tool for creating reusable select inputs.
 
 
 ## Features
@@ -20,42 +20,6 @@ The aim of Slectoo is to provide a flexible tool for creating reusable select in
 - dependent / cascading inputs
 
 
-## Notable differences compared to Nette SelectBox & MultiSelectBox
-
-- lazy options loading using a callback
-- disabling a Selectoo input does not modify/reset its value, so it can be re-enabled without the loss of the information
-
-
-## Lazy options loading
-
-Lazy loading is used when the Selectoo instance is given "item callback" callable instead of an array of items.
-The callable is supposed to return a list of items.
-
-The item callback also works as a validator for values.
-It receives raw value as the first argument (and the input instance as the second).
-The callback should return the array of possible values (these are the items) in form
-exactly the same as the items set to `SelectBox` or `MultiSelectBox` inputs.
-The raw value is then compared to the returned items and filtered.
-This approach ensures the validity of the data.
-
-It is important to set this callback in case you work with remote item loading (ajax/api loading of options).
-
-
-## Supported and intended UI libraries
-
-Selectoo uses "script engines" to generate JavaScript UI scripts along with HTML input element.
-Any script engine can be attached to the `Selectoo` instance by calling `$selectoo->setEngine($engine)`.
-
-- [select2/select2](https://github.com/select2/select2)
-	- use the `Select2Engine` instances
-- selectize/selectize.js
-	- to be implemented
-- harvesthq/chosen
-	- to be implemented
-
-Custom engines can easily be created implementing the `ScriptEngineInterface` interface.
-
-
 ## Usage / Use cases
 
 **Reusable** inputs with specific setup:
@@ -99,13 +63,43 @@ The `Select2Engine` is configured using magic options (or `setOption` method).
 The names of the magic methods (or option names) represent the ***Select2* configuration options**.
 
 
-## Script management
+## Lazy options loading & AJAX
 
-The scripts generated by engines can be post-processed and/or collected by a management routine.
-This approach can be used to gather and place the scripts at the end of the page and to solve problems
-when writing scripts inside the page and loading jQuery at the end of the HTML file.
+Lazy loading is used when the Selectoo instance is given "item callback" callable instead of an array of items.
+The callable is supposed to return a list of items.
 
-See [script-management example](examples/script-management/Select2SelectooWithCollectorFactory.php) for more information.
+The item callback also works as a validator for values.
+It receives raw value as the first argument (and the input instance as the second).
+The callback should return the array of possible values (these are the items) in form
+exactly the same as the items set to `SelectBox` or `MultiSelectBox` inputs.
+The raw value is then compared to the returned items and filtered.
+This approach ensures the validity of the data.
+
+It is important to set this callback in case you work with remote item loading (ajax/api loading of options).
+
+See the [example ajax presenter](examples/ajax/ExamplePresenter.php),
+complete with input factory and user repository examples.
+
+Ajax configuration can be very simple:
+```php
+(new Select2Engine())
+	->ajax('{url: "' . $link . '", dataType: "json" }')
+;
+```
+
+## Supported and intended UI libraries
+
+Selectoo uses "script engines" to generate JavaScript UI scripts along with HTML input element.
+Any script engine can be attached to the `Selectoo` instance by calling `$selectoo->setEngine($engine)`.
+
+- [select2/select2](https://github.com/select2/select2)
+	- use the `Select2Engine` instances
+- selectize/selectize.js
+	- to be implemented
+- harvesthq/chosen
+	- to be implemented
+
+Custom engines can easily be created implementing the `ScriptEngineInterface` interface.
 
 
 ## Factories
@@ -120,17 +114,13 @@ See simple examples:
 - [example AJAX API loaded input](examples/ajax/UserAjaxSelectooFactory.php)
 
 
-## Lazy loading & AJAX
+## Script management
 
-See the [example ajax presenter](examples/ajax/ExamplePresenter.php),
-complete with input factory and user repository examples.
+The scripts generated by engines can be post-processed and/or collected by a management routine.
+This approach can be used to gather and place the scripts at the end of the page and to solve problems
+when writing scripts inside the page and loading jQuery at the end of the HTML file.
 
-Ajax configuration can be very simple:
-```php
-(new Select2Engine())
-	->ajax('{url: "' . $link . '", dataType: "json" }')
-;
-```
+See [script-management example](examples/script-management/Select2SelectooWithCollectorFactory.php) for more information.
 
 
 ## Dependent selections / cascading inputs
@@ -151,6 +141,12 @@ What is needed, in general:
 By following these steps, dependent Selectoo inputs can be created and values validated.
 
 
+## Notable differences compared to Nette SelectBox & MultiSelectBox
+
+- disabling a Selectoo input does not modify/reset its value, so it can be re-enabled without the loss of the information
+- disabled input is handled differently - raw value is always loaded even when input (or items) is disabled. The disabled values are filtered when calling `getValue` method.
+
+
 ## Requirements
 
 - PHP 7+