Update options.md

Author: JonathanMagnan

docs/pages/api/options.md

@@ -1,73 +1,58 @@
 ---
 layout: default
 title: Options
+description: Options to customize the context under which the C# expression is compiled.
 permalink: options
 ---
 
 {% include template-h1.html %}
 
-## Introduction
-The EvalContext allow customizing multiple options to change the context under which the code or expression is compiled.
+## Description
+{{ page.description }}
 
 ## BindingFlags
-### Problem
-You want to change default BindingFlags used to retrieve member (Constructor, Method, Property, and Field)
-
-### Solution
-Use the **BindingFlags** property.
+Gets or sets the value of the BindingFlags to use to retrieve member (Constructor, Method, Property, and Field)
 
 ### Example
-```csharp
+{% highlight csharp %}
 // using Z.Expressions; // Don't forget to include this.
 var context = new EvalContext();
 
 // Make member case insensitive (Math.pOW = Math.Pow)
 context.BindingFlags = BindingFlags.IgnoreCase | context.BindingFlags
-```
+{% endhighlight %}
 
 ## CacheKeyPrefix
-### Problem
-You want to change the cache key prefix used to cache compiled expression.
+Gets or sets the can key prefix to use to cache compiled delegate in the memory.
 
-### Solution
-Use the **CacheKey** property.
+> We recommend always to use a different cache key prefix if you modify the options.
 
 ### Example
-```csharp
+{% highlight csharp %}
 // using Z.Expressions; // Don't forget to include this.
 var context = new EvalContext();
 context.CacheKey = Guid.NewGuid().ToString();
-```
-
-### Discussion
-We recommend always to use a different cache key prefix if you use different options.
+{% endhighlight %}
 
 ## UseCache
-### Problem
-You want to disable the caching for compiled expression.
+Gets or sets if compiled delegate shoud be cached in the memory or not. 
 
-### Solution
-Use the **UseCache** property.
+> This configuration can be very useful to disable if you execute multiple expression only once, and you believe they will never be re-used.
 
 ### Example
-```csharp
+{% highlight csharp %}
 // using Z.Expressions; // Don't forget to include this.
 var context = new EvalContext();
 context.UseCache = false;
-```
-
-### Discussion
-This configuration can be very useful to disable if you execute multiple expression only once, and you believe they will never be re-used.
+{% endhighlight %}
 
 ## UseCaretForExponent
-### Problem
-You want to change the XOR operator '^' to act like an exponent operator instead.
+Gets or sets if the default behavior for the XOR operator '^' must act like an exponent operator instead.
 
-### Solution
-Use the **UseCaretForExponent** property.
+> A new operator '^|' is available for the bitwise exclusive-OR operator.
 
 ### Example
-```csharp
+{% highlight csharp %}
 // using Z.Expressions; // Don't forget to include this.
 var context = new EvalContext() { UseCache = false };
 
@@ -77,23 +62,15 @@ context.UseCaretForExponent = true;
 var exponentValue = = context.Eval("2^3"); // return 8;
 
 var newExlusiveOrValue = = context.Eval("2^|3"); // return 1;
-```
-
-### Discussion
-A new operator '^|' is available for the bitwise exclusive-OR operator.
+{% endhighlight %}
 
 ## Clone
-### Problem
-You want to make a shallow copy of the current EvalContext
+Create a new a shallow copy of the current EvalContext
 
-### Solution
-Use the **Clone** method.
+> Cloning the EvalContext can be useful to copy all options including all types already registered to use it to change only what's required for the expression to evaluate.
 
 ### Example
-```csharp
+{% highlight csharp %}
 // using Z.Expressions; // Don't forget to include this.
 var context = EvalManager.DefaultContext.Clone();
-```
-
-### Discussion
-Cloning the EvalContext can be useful to copy all options including all types already registered to use it to change only what's required for the expression to evaluate.
+{% endhighlight %}