diff --git a/docs/graph2d.html b/docs/graph2d.html
index 67414a99..5f8b8f0a 100644
--- a/docs/graph2d.html
+++ b/docs/graph2d.html
@@ -113,7 +113,8 @@
   Groups is a vis DataSet containing groups. The available options and the method of construction
   are described in section Data Format.
 
var graph = new vis.Graph2d(container [, data] [, options] [,groups]);+
var graph = new vis.Graph2d(container [, data] [, groups] [, options]);+For backwards compatibility, groups and options can be interchanged.
   Data, options and groups can be set or changed later on using the functions
diff --git a/docs/timeline.html b/docs/timeline.html
index fb02ad90..33587026 100644
--- a/docs/timeline.html
+++ b/docs/timeline.html
@@ -111,17 +111,21 @@
 
 The constructor of the Timeline is vis.Timeline
 
var timeline = new vis.Timeline(container, items, options);+or when using groups: +
var timeline = new vis.Timeline(container, items, groups, options);- -The constructor accepts three parameters: +The constructor accepts four parameters:
container is the DOM element in which to create the timeline.
   items is an Array containing items. The properties of an
-    item are described in section Data Format.
-  groups is an Array containing groups. The properties of a
+        group are described in section Data Format, groups.
+    options is an optional Object containing a name-value map
     with options. Options can also be set using the method
@@ -259,7 +263,7 @@ var items = [
   content, and className (optional).
 
 
-  Groups can be applied to a timeline using the method setGroups.
+  Groups can be applied to a timeline using the method setGroups or supplied in the constructor.
   A table with groups can be created like: