Update website

Update website

Author: zzzprojects

docs/_data/meta.csv

@@ -84,3 +84,4 @@ custom-key,custom-key,custom-key,custom-key,Custom key,,,no,container-doc,sectio
 fastest-way-to-insert,fastest-way-to-insert,fastest-way-to-insert,fastest-way-to-insert,Fastest Way to Insert,,,no,container-doc,section-article
 improve-bulk-savechanges,improve-bulk-savechanges,improve-bulk-savechanges,improve-bulk-savechanges,Improve BulkSaveChanges,,,no,container-doc,section-article
 soft-delete,soft-delete,soft-delete,soft-delete,Soft Delete,,,no,container-doc,section-article
+bulk-insert-vs-bulk-savechanges,BulkInsert vs BulkSaveChanges,BulkInsert vs BulkSaveChanges,,BulkInsert vs BulkSaveChanges,,,no,container-doc,section-article

docs/_includes/custom/section-aside.html

@@ -0,0 +1,13 @@
+<br />
+<nav class="card card-box card-box-light card-box-nav">
+	<div class="card-header">
+		<h3>Quick Links</h3>
+	</div>
+	<div class="card-body">
+		<ul style="padding-left: 0">		
+			<li><a href="{{ site.github.url }}/bulk-insert-vs-bulk-savechanges">BulkInsert vs BulkSaveChanges</a></li>
+			<li><a href="{{ site.github.url }}/improve-bulk-savechanges">Improve BulkSaveChanges</a></li>
+			<li><a href="{{ site.github.url }}/include-graph">Include Graph</a></li>
+		</ul>
+	</div>
+</nav>

docs/_includes/custom/section-sidebar.html

@@ -66,6 +66,7 @@ <h3>Options</h3>
 
 		<h3>Articles</h3>
 		<ul>
+			<li><a href="{{ site.github.url }}/bulk-insert-vs-bulk-savechanges">BulkInsert vs BulkSaveChanges</a></li>
 			<li><a href="{{ site.github.url }}/benchmark">Make Benchmark</a></li>
 			<li><a href="{{ site.github.url }}/improve-bulk-savechanges">Improve BulkSaveChanges</a></li>
 			<li><a href="{{ site.github.url }}/custom-column">Use Custom Column</a></li>

docs/_includes/custom/site-header.html

@@ -15,7 +15,7 @@
 			<div class="navbar-collapse collapse justify-content-end" id="nav-site-menu">		
 				<ul class="navbar-nav">
 					<li class="nav-item">
-						<a class="nav-link" href="{{ site.github.url }}/tutorials">
+						<a class="nav-link" href="{{ site.github.url }}/overview">
 							<i class="fa fa-book" aria-hidden="true"></i>
 							Tutorials
 						</a>
@@ -61,7 +61,7 @@
 						</a>
 					</li>
 					<li class="nav-item {{ is_menu_context_api_css_active }}">			
-						<a class="nav-link" href="{{ site.github.url }}/api">
+						<a class="nav-link" href="{{ site.github.url }}/bulk-savechanges">
 							API
 						</a>
 					</li>

docs/_layouts/default.html

@@ -65,6 +65,9 @@ <h1>{{site.data.meta[meta_index].h1}}</h1>
 					{{ content }}
 				</div>
 				<div class="col-lg-2 col-xl-2 section-aside hidden-md-down">
+					<div class="section-aside-inner">
+						{% include custom/section-aside.html %}
+					</div>
 				</div>
 			</div>
 		</div>

docs/_sass/component-card-box.scss

@@ -21,7 +21,7 @@
 //
 //	card-box-nav 
 //
-.card-box-nav .card-body h5:not(:first-child) {
+.card-box-nav .card-body h3:not(:first-child) {
 	margin-top: 15px;
 }
 .card-box-nav .card-body ul {

docs/_sass/component-rotator-dark.scss

@@ -11,6 +11,7 @@
 @media (min-width: 992px) {
 	.rotator .rotator-header {
 		transform: rotate(4deg);
+		position: relative;
 		z-index: 1;
 	}
 	.rotator .rotator-header-inner {

docs/_sass/section.scss

@@ -29,8 +29,14 @@
 
 
 //
-// section-aside: TODO
+// section-aside
 //
+.section-aside {
+	position: relative;
+}
+.section-aside-inner {
+	position: fixed;
+}
 
 //
 //

docs/_sass/site-default.scss

@@ -26,6 +26,13 @@ input.form-control:focus{
 	}
 }
 
+//
+// container
+//
+.container-page {
+	padding-bottom: 80px;
+}
+
 //
 // bootstrap hidden restore
 //

docs/pages/articles/bulk-insert-vs-bulk-savechanges.md

@@ -0,0 +1,39 @@
+---
+permalink: bulk-insert-vs-bulk-savechanges
+---
+
+## What’s the difference between BulkInsert and BulkSaveChanges?
+BulkInsert will always be a lot faster than BulkSaveChanges.
+
+BulkSaveChanges work like SaveChanges but faster. It uses the Change Tracker to get the list of entities and check the Entity State to know which operation should be performed. 
+
+In counterpart, Bulk methods such as BulkInsert, BulkUpdate, and BulkDelete doesn’t use at all the Change Tracker to make these methods as efficient as possible. It takes the list of entities from the parameter provided and doesn’t care about the Entity State.
+
+## Should I always use BulkInsert?
+No! Even if BulkInsert is faster.
+
+BulkSaveChanges even if slower make everything easier. All you need to do is adding “Bulk” before “SaveChanges” and everything work as expected.
+
+BulkInsert require more time to implement when you have several different lists to insert. You need to create/handle a transaction in your code and specify yourself the right order to save.
+
+## We normally recommend always to use BulkSaveChanges unless you have some critical section you want to boost even more the performance.
+How is transaction handled?
+
+BulkSaveChanges as SaveChanges create an internal transaction. So, by default, there is nothing to do.
+
+BulkInsert doesn’t create a transaction by default. If you want to save multiple lists, you will need to handle the transaction in your code.
+
+{% include template-example.html %} 
+{% highlight csharp %}
+var transaction = context.Database.BeginTransaction();
+try
+{
+	context.BulkInsert(list1);
+	context.BulkInsert(list2);
+	transaction.Commit();
+}
+catch
+{
+	transaction.Rollback();
+}
+{% endhighlight %}