add has documentation and update README

Author: clmath

README.md

@@ -2,13 +2,14 @@
 
 Set of AMD plugins for RequireJS. It contains the following plugins:
 
+ * [has](#has)
  * [i18n](#i18n)
  * [maybe](#maybe)
 
 ## Status
 
 No official release yet.
- 
+
 ## Migration
 
 ## Licensing
@@ -38,46 +39,13 @@ Then install dependencies with bower (or manually from github if you prefer to):
 	$ bower install
 
 ## Documentation
-### i18n
-This plugin is based on requirejs i18n but modified to support nls built layer.
-
-#### When the application IS NOT optimized
-If an application is not built, this plugin will behave exactly like the i18n plugin from RequireJS.
-The appropriate documentation can be found on [RequireJS website](http://requirejs.org/docs/api.html#i18n).
-
-#### When the application IS optimized
-Once the application is built, the plugin offer three new options:
-
-```
-requirejs.config({
-    config: {
-        i18n: {
-            layerOnly: bool,    //default: false
-            languagePack: bool, //default: false
-            enhanceLayer: bool, //default: true
-        }
-    }
-
-});
-```
- * `layerOnly` (default: false)
-
-    If `layerOnly = true`, the plugin is only looking for nls bundles in built nls layers. `layerOnly` must be true if only the built nls layers are deployed with the application.
-    If the individual nls bundles are also deployed, `layerOnly` should be false.
 
- * `languagePack` (default: false)
-    
-    If true, this option gives the possibility to add new locales to the application just by adding the corresponding built nls layer. However, this will result in more http requests (and some expected 404 in the console), so it should only be used in low latency environments (like cordova applications).
- * `enhanceLayer` (default: true)
+### has
+See [docs/has.md](./docs/has.md).
 
-    This option is ignored if `layerOnly = true`.
+### i18n
+See [docs/i18n.md](./docs/has.md).
 
-    This option defines the behaviour of the plugin when a bundle is retrieved from a layer with a less specific locale than requested (ie: bundle `en` from layer when `en-us` was requested).
-        
-    * If `enhanceLayer = false`, the plugin only uses the bundle from the layer. This is useful when a part of the application is an already built package distributed without the individual nls bundles.
-    
-    * If `enhanceLayer = true`, the plugin will try to load a more specific individual bundle if one exist.
- 
 
 
 ### maybe

docs/has.md

@@ -0,0 +1,112 @@
+---
+layout: default
+title: requirejs-dplugins/has
+---
+
+# requirejs-dplugins/has
+
+`requirejs-dplugins/has` provides standardized feature detection with an extensible API. It also implements the
+[requirejs plugin api](http://requirejs.org/docs/plugins.html) to provide conditional module loading.
+
+It is based on the conventions in the [has.js project](https://github.com/phiggins42/has.js).
+
+Note: This plugin does NOT include any feature tests.
+
+##### Table of Contents
+[Features](#features)  
+[Adding tests](#adding-tests)  
+[Use as module](#use-as-module)  
+[Use as plugin](#use-as-plugin)  
+
+## Features
+
+* __lazy evaluation__: Tests are only evaluated when they are required by the application.
+* __test result caching__: tests results are stored for later use to minimize the impact on resources.
+* __static configuration__: Tests can be set statically using requirejs configuration, providing support for configuration
+flag.
+* __requirejs plugin__: Use ternary operator to conditionally load modules.
+
+## Adding tests
+
+Since the plugin itself does not include any tests, the first thing to do is add one.
+
+### Using has.add()
+
+The plugin provides an `add` function to add new tests, with the following signature:
+
+```js
+has.add(name, test, now, force)
+```
+1. name _(String)_: The test name.
+1. test _(Boolean or Function)_: The test function or directly a `Boolean` value. The test function will be call with a
+single `global` argument pointing to the global scope.
+1. now _(Boolean)_: If true, evaluate the test function now instead of when it will be needed.
+1. force _(Boolean)_: If true, add the test even if a test with the same name already exists.
+
+#### Sample
+```js
+define(["requirejs-dplugins/has"], function (has) {
+	// using a boolean directly
+	has.add("host-browser", typeof window !== "undefined");
+
+	// using a test function and overwriting previous tests
+	has.add("host-browser", function (global) {
+		return global.window !== undefined;
+	}, false, true);
+});
+```
+
+### Using static configuration
+
+The plugin will look for static configuration in a hashmap provided through
+[requirejs module configuration](http://requirejs.org/docs/api.html#config-moduleconfig).
+
+#### Sample
+```js
+require.config({
+	config: {
+		"requirejs-dplugins/has": {
+			// Create a bidi flag.
+			bidi: true
+		}
+	}
+});
+```
+
+## Use as module
+To access the tests, the plugin exports a main function taking a test name as argument and returning the test result.
+
+#### Sample
+```js
+define(["requirejs-dplugins/has"], function (has) {
+	if (has("bidi")) {
+		// Do something special to support bidi
+	}
+});
+```
+
+## Use as plugin
+Ternary operator can be used to conditionally load modules. It uses the following syntax:
+
+```
+test?moduleA:moduleB
+```
+
+If `test` return true, `moduleA` will be loaded, otherwise it will be `moduleB`.
+Note that `moduleA` and `moduleB` are optional and if the expression doesn't resolve to a module, the plugin returns
+`undefined`.
+
+Ternary operation can be chained to run another test if the first one fails.
+```
+test1?moduleA:test2?moduleB:moduleC
+```
+If `test1` is true, the plugin loads `moduleA`.
+If `test1` is false but `test2` is true, the plugin loads `moduleB`.
+If `test1` is false and `test2` is false, the plugin loads `moduleC`.
+
+#### Sample
+```js
+define(["requirejs-dplugins/has!bidi?./bidiWidget:./Widget"], function (widget) {
+	// Do something with the widget
+});
+```