diff --git a/docs/timeline.html b/docs/timeline.html
index 613ae09f..1284fc5a 100644
--- a/docs/timeline.html
+++ b/docs/timeline.html
@@ -68,16 +68,23 @@
 <div id="visualization"></div>
 
 <script type="text/javascript">
+  // DOM element where the Timeline will be attached
   var container = document.getElementById('visualization');
-  var items = [
+
+  // Create a DataSet (allows two way data-binding)
+  var items = new vis.DataSet([
     {id: 1, content: 'item 1', start: '2013-04-20'},
     {id: 2, content: 'item 2', start: '2013-04-14'},
     {id: 3, content: 'item 3', start: '2013-04-18'},
     {id: 4, content: 'item 4', start: '2013-04-16', end: '2013-04-19'},
     {id: 5, content: 'item 5', start: '2013-04-25'},
     {id: 6, content: 'item 6', start: '2013-04-27'}
-  ];
+  ]);
+
+  // Configuration for the Timeline
   var options = {};
+
+  // Create a Timeline
   var timeline = new vis.Timeline(container, items, options);
 </script>
 </body>
diff --git a/examples/timeline/01_basic.html b/examples/timeline/01_basic.html
index 5dc030e0..289555f7 100644
--- a/examples/timeline/01_basic.html
+++ b/examples/timeline/01_basic.html
@@ -16,16 +16,23 @@
 <div id="visualization"></div>
 
 <script type="text/javascript">
+  // DOM element where the Timeline will be attached
   var container = document.getElementById('visualization');
-  var items = [
+
+  // Create a DataSet (allows two way data-binding)
+  var items = new vis.DataSet([
     {id: 1, content: 'item 1', start: '2014-04-20'},
     {id: 2, content: 'item 2', start: '2014-04-14'},
     {id: 3, content: 'item 3', start: '2014-04-18'},
     {id: 4, content: 'item 4', start: '2014-04-16', end: '2014-04-19'},
     {id: 5, content: 'item 5', start: '2014-04-25'},
     {id: 6, content: 'item 6', start: '2014-04-27', type: 'point'}
-  ];
+  ]);
+
+  // Configuration for the Timeline
   var options = {};
+
+  // Create a Timeline
   var timeline = new vis.Timeline(container, items, options);
 </script>
 </body>
diff --git a/examples/timeline/02_interactive.html b/examples/timeline/02_interactive.html
index 0c4f6d36..e555b29c 100644
--- a/examples/timeline/02_interactive.html
+++ b/examples/timeline/02_interactive.html
@@ -21,9 +21,14 @@
 
 <script>
   // create a dataset with items
+  // we specify the type of the fields `start` and `end` here to be strings
+  // containing an ISO date. The fields will be outputted as ISO dates
+  // automatically getting data from the DataSet via items.get().
   var items = new vis.DataSet({
     type: { start: 'ISODate', end: 'ISODate' }
   });
+
+  // add items to the DataSet
   items.add([
     {id: 1, content: 'item 1<br>start', start: '2014-01-23'},
     {id: 2, content: 'item 2', start: '2014-01-18'},
diff --git a/examples/timeline/04_html_data.html b/examples/timeline/04_html_data.html
index 47997fd3..c7c1609d 100644
--- a/examples/timeline/04_html_data.html
+++ b/examples/timeline/04_html_data.html
@@ -58,7 +58,7 @@
 
   // create data and a Timeline
   var container = document.getElementById('visualization');
-  var items = [
+  var items = new vis.DataSet([
     {id: 1, content: item1, start: '2013-04-20'},
     {id: 2, content: item2, start: '2013-04-14'},
     {id: 3, content: item3, start: '2013-04-18'},
@@ -66,7 +66,7 @@
     {id: 5, content: item5, start: '2013-04-25'},
     {id: 6, content: item6, start: '2013-04-27'},
     {id: 7, content: item7, start: '2013-04-21'}
-  ];
+  ]);
   var options = {};
   var timeline = new vis.Timeline(container, items, options);
 </script>
diff --git a/examples/timeline/07_custom_time_bar.html b/examples/timeline/07_custom_time_bar.html
index 07ebe3cf..d40b76fc 100644
--- a/examples/timeline/07_custom_time_bar.html
+++ b/examples/timeline/07_custom_time_bar.html
@@ -34,7 +34,7 @@
 
 <script type="text/javascript">
   var container = document.getElementById('visualization');
-  var items = [];
+  var items = new vis.DataSet();
   var options = {
     showCurrentTime: true,
     showCustomTime: true,
diff --git a/examples/timeline/10_limit_move_and_zoom.html b/examples/timeline/10_limit_move_and_zoom.html
index 37006aa5..2f622cb7 100644
--- a/examples/timeline/10_limit_move_and_zoom.html
+++ b/examples/timeline/10_limit_move_and_zoom.html
@@ -28,10 +28,10 @@
 <script>
   // create some items
   // note that months are zero-based in the JavaScript Date object, so month 4 is May
-  var items = [
+  var items = new vis.DataSet([
     {'start': new Date(2012, 4, 25), 'content': 'First'},
     {'start': new Date(2012, 4, 26), 'content': 'Last'}
-  ];
+  ]);
 
   // create visualization
   var container = document.getElementById('visualization');
diff --git a/examples/timeline/11_points.html b/examples/timeline/11_points.html
index bfc4797f..9ae67166 100755
--- a/examples/timeline/11_points.html
+++ b/examples/timeline/11_points.html
@@ -23,7 +23,7 @@
   var container = document.getElementById('visualization');
 
   // note that months are zero-based in the JavaScript Date object
-  var items = [
+  var items = new vis.DataSet([
     {start: new Date(1939,8,1),  content: 'German Invasion of Poland'},
     {start: new Date(1940,4,10), content: 'Battle of France and the Low Countries'},
     {start: new Date(1940,7,13), content: 'Battle of Britain - RAF vs. Luftwaffe'},
@@ -44,7 +44,7 @@
     {start: new Date(1944,1,19), content: 'American Landings on Iwo Jima'},
     {start: new Date(1945,3,1),  content: 'US Invasion of Okinawa'},
     {start: new Date(1945,3,16), content: 'Battle of Berlin - End of the Third Reich'}
-  ];
+  ]);
 
   var options = {
     // Set global item type. Type can also be specified for items individually
diff --git a/examples/timeline/12_custom_styling.html b/examples/timeline/12_custom_styling.html
index 8e87b5ce..e43ab3fb 100644
--- a/examples/timeline/12_custom_styling.html
+++ b/examples/timeline/12_custom_styling.html
@@ -67,7 +67,7 @@
   var container = document.getElementById('visualization');
 
   // note that months are zero-based in the JavaScript Date object
-  var items = [
+  var items = new vis.DataSet([
     {start: new Date(2010,7,23), content: '<div>Conversation</div><img src="img/community-users-icon.png" style="width:32px; height:32px;">'},
     {start: new Date(2010,7,23,23,0,0), content: '<div>Mail from boss</div><img src="img/mail-icon.png" style="width:32px; height:32px;">'},
     {start: new Date(2010,7,24,16,0,0), content: 'Report'},
@@ -76,7 +76,7 @@
     {start: new Date(2010,7,29), content: '<div>Phone call</div><img src="img/Hardware-Mobile-Phone-icon.png" style="width:32px; height:32px;">'},
     {start: new Date(2010,7,31), end: new Date(2010,8,3), content: 'Traject B'},
     {start: new Date(2010,8,4,12,0,0), content: '<div>Report</div><img src="img/attachment-icon.png" style="width:32px; height:32px;">'}
-  ];
+  ]);
 
   var options = {
     editable: true,
diff --git a/examples/timeline/15_item_class_names.html b/examples/timeline/15_item_class_names.html
index 903f9d96..ea1d14ef 100755
--- a/examples/timeline/15_item_class_names.html
+++ b/examples/timeline/15_item_class_names.html
@@ -74,7 +74,7 @@
 <script type="text/javascript">
   // create data
   // note that months are zero-based in the JavaScript Date object
-  var data = [
+  var data = new vis.DataSet([
     {
       'start': new Date(2012,7,19),
       'content': 'default'
@@ -100,7 +100,7 @@
       'content': 'magenta',
       'className': 'magenta'
     }
-  ];
+  ]);
 
   // specify options
   var options = {
diff --git a/examples/timeline/16_navigation_menu.html b/examples/timeline/16_navigation_menu.html
index 19ff5d79..a51d435d 100755
--- a/examples/timeline/16_navigation_menu.html
+++ b/examples/timeline/16_navigation_menu.html
@@ -38,14 +38,14 @@
 <script type="text/javascript">
     // create a timeline with some data
     var container = document.getElementById('visualization');
-    var items = [
+    var items = new DataSet([
         {id: 1, content: 'item 1', start: '2014-04-20'},
         {id: 2, content: 'item 2', start: '2014-04-14'},
         {id: 3, content: 'item 3', start: '2014-04-18'},
         {id: 4, content: 'item 4', start: '2014-04-16', end: '2014-04-19'},
         {id: 5, content: 'item 5', start: '2014-04-25'},
         {id: 6, content: 'item 6', start: '2014-04-27', type: 'point'}
-    ];
+    ]);
     var options = {};
     var timeline = new vis.Timeline(container, items, options);