Improve doc #218

Author: l-lin

demo/advanced/serverSideProcessing.html

@@ -36,6 +36,12 @@ <h1><i class="fa fa-play"></i>&nbsp;Server side processing</h1>
                 <li>
                     By default, <code>angular-datatables</code> set the <a href="http://datatables.net/reference/option/ajax.dataSrc"><code>AjaxDataProp</code></a> to <code>''</code>. So you need to provide the <code>AjaxDataProp</code> with either <code>.withDataProp('data')</code> or specifying the option <code>dataSrc</code> in the <code>ajax</code> option.
                 </li>
+                <li>
+                    If your server takes a while to process the data, I advise you set the attribute
+                    <a href="https://datatables.net/reference/option/processing"><code>processing</code></a> to <code>true</code>.
+                    This will display a message that warn the user that the table is processing instead of having a
+                    "freezing-like" table.
+                </li>
             </ul>
         </div>
         <p class="text-warning">
@@ -74,6 +80,7 @@ <h1><i class="fa fa-play"></i>&nbsp;Server side processing</h1>
      })
      // or here
      .withDataProp('data')
+        .withOption('processing', true)
         .withOption('serverSide', true)
         .withPaginationType('full_numbers');
     vm.dtColumns = [

demo/advanced/serverSideProcessing.js

@@ -6,7 +6,7 @@ function ServerSideProcessingCtrl(DTOptionsBuilder, DTColumnBuilder) {
     var vm = this;
     vm.dtOptions = DTOptionsBuilder.fromSource('data.json')
         .withPaginationType('full_numbers');
-    // vm.dtOptions = DTOptionsBuilder.newOptions()
+    //vm.dtOptions = DTOptionsBuilder.newOptions()
     //     .withOption('ajax', {
     //      // Either you specify the AjaxDataProp here
     //      // dataSrc: 'data',
@@ -15,6 +15,7 @@ function ServerSideProcessingCtrl(DTOptionsBuilder, DTColumnBuilder) {
     //  })
     //  // or here
     //  .withDataProp('data')
+    //    .withOption('processing', true)
     //     .withOption('serverSide', true)
     //     .withPaginationType('full_numbers');
     vm.dtColumns = [

demo/basic/overrideLoadingTpl.html

@@ -3,6 +3,21 @@
         <h1><i class="fa fa-play"></i>&nbsp;Override <code>Loading</code> template</h1>
     </header>
     <section class="article-content">
+        <p>
+            There are two loading with angular-datatables:
+        </p>
+        <ul>
+            <li>
+                One comes from this module. It is displayed before the table is rendered. This loading has been added because
+                angular-datables offers the possibility to fetch the data and options with promises. So before rendering the
+                table, the promises need to be resoved, thus adding a loading message to let users know that something is
+                processing.
+            </li>
+            <li>
+                The other comes from DataTables. The message <code>Loading</code> is displayed inside the Table while fetching
+                the data from the server.
+            </li>
+        </ul>
         <p>
             When loading data, the angular module will display by default <code>&lt;h3 class="dt-loading"&gt;Loading...&lt;/h3&gt;</code>.
         </p>