Add news articles

Add news articles

Author: zzzprojects

docs/_data/meta.csv

@@ -87,3 +87,5 @@ soft-delete,soft-delete,soft-delete,soft-delete,Soft Delete,,,no,container-doc,s
 bulk-insert-vs-bulk-savechanges,BulkInsert vs BulkSaveChanges,BulkInsert vs BulkSaveChanges,,BulkInsert vs BulkSaveChanges,,,no,container-doc,section-article
 articles,Articles,Articles,,Articles,,,no,container-doc,section-article
 trial,Trial,Trial,,Trial,,,no,container-doc,section-article
+edmx,Edmx,Edmx,,Edmx,,,no,container-doc,section-article
+out-of-memory,Out of memory,Out of memory,,Out of memory,,,no,container-doc,section-article

docs/_includes/custom/section-sidebar.html

@@ -77,7 +77,10 @@ <h3>Customizations</h3>
 			<li><a href="{{ site.github.url }}/soft-delete">Soft Delete</a></li>
 			<li><a href="{{ site.github.url }}/concurrency">Concurrency</a></li>
 		</ul>
-
+		<h3>Misc</h3>
+		<ul>
+			<li><a href="{{ site.github.url }}/edmx">Edmx</a></li>
+		</ul>
 	</div>
 </nav>
 
@@ -114,6 +117,7 @@ <h3>Concurrency</h3>
 		<h3>General</h3>
 		<ul>
 			<li><a href="{{ site.github.url }}/foreign-key-constraint-autodetectchanges-disabled">Foreign Key Constraint</a></li>
+			<li><a href="{{ site.github.url }}/out-of-memory">Out of Memory</a></li>
 		</ul>
 
 		<h3>Type</h3>

docs/pages/articles/emdx.md

@@ -0,0 +1,35 @@
+---
+permalink: edmx
+---
+
+In a rare occasion, your model might not still compatible yet with our model reader. If that's your case and we ask you for your model, you can use one of the following methods to provide the required information:
+
+## Code First
+Use the `GetModelXDocument` method to generate the Edmx to send.
+
+{% include template-example.html %} 
+{% highlight csharp %}
+public string GetModelXDocument(DbContext context)
+{
+    XDocument doc;
+    using (var memoryStream = new MemoryStream())
+    {
+        using (XmlWriter xmlWriter = XmlWriter.Create(memoryStream, new XmlWriterSettings { Indent = true }))
+        {
+            EdmxWriter.WriteEdmx(context, xmlWriter);
+        }
+ 
+        memoryStream.Position = 0;
+ 
+        doc = XDocument.Load(memoryStream);
+    }
+    return doc.ToString();
+}
+
+DbContext context = new EntityContext();
+string edmx = GetModelXDocument();
+{% endhighlight %}
+
+
+## Database First
+Provide us the [fileName].edmx directly.

docs/pages/problems/out-of-memory.md

@@ -0,0 +1,36 @@
+---
+permalink: out-of-memory
+---
+
+## Problem
+
+You execute a method from the Entity Framework Extensions library, and the following error is thrown:
+
+{% include template-exception.html message='An exception of type `System.OutOfMemoryException` occured in...' %}
+
+## Cause
+That error is caused when the library consumes too much memory.
+
+Most of the time, this error is caused by some methods used from `Entity Framework` for command generations that will be used later by our library.
+
+### Fix
+Turning off Entity Framework Propagation
+
+This solution work with around 99% of model. By turning off this options, our library doesn’t longer use several methods from Entity Framework that consume high memory such as the command generations.
+
+See: <a href="/improve-bulk-savechanges">Improve BulkSaveChanges</a>
+
+### Bulk Operations
+In some exceptional scenario, using Bulk Operations such as:
+
+- BulkInsert
+- BulkUpdate
+- BulkDelete
+- BulkMerge
+
+might may a better idea. They are faster and consume way less memory than BulkSaveChanges.
+
+### Reduce the number of entities in the ChangeTracker
+Another way is to make sure the ChangeTracker doesn’t contain too many entities.
+
+The ChangeTracker has not been build to support millions entities.