X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fmkws-developer.markdown;h=f0340a2cfee4c6ab6a73f97e138d4f47a2064ba5;hb=bc3f59298d3a037d1e8b719e525db700ecc893bd;hp=c678b83e64c16a2d50c2c7acc218cefae7bbf9a2;hpb=c870e985a11ff112ffa67b377a3989974abe09af;p=mkws-moved-to-github.git

diff --git a/doc/mkws-developer.markdown b/doc/mkws-developer.markdown
index c678b83..f0340a2 100644
--- a/doc/mkws-developer.markdown
+++ b/doc/mkws-developer.markdown
@@ -148,9 +148,24 @@ be used by the derived widget.
 	`responsive_design_width`. Should be used for "unimportant"
 	widgets that can be omitted from the mobile version of a site.
 
-* TODO subwidget()
-
-* TODO expandValue()
+* `expandValue()` --
+	TODO: either document this or remove it from the API.
+
+* `subwidget(type, overrides, defaults)` --
+	Returns the HTML of a subwidget of the specified type, which
+	can then be inserted into the widget using the
+	`this.node.html` function. The subwidget is given the same
+	attributes at the parent widget that invokes this function,
+	except where overrides are passed in. If defaults are also
+	provided, then these are used when the parent widget provides
+	no values. Both the `overrides` and `defaults` arguments are
+	hashes: the latter is optional.
+  
+	See for example the `Credo` widget defined in the example
+	area's `mkws-widget-credo.js` file. This uses several
+	invocations of `subwidget` to create a complex compound widget
+	with numerous text, facet and image panes. TODO: rename this
+	widget and everything related to it.
 
 In addition to these properties and methods of the bare widget object,
 some kinds of specific widget add other properties of their own. For
@@ -243,4 +258,4 @@ TODO: list of events that can be usefully subscribed to.
 
 - - -
 
-Copyright (C) 2013-2014 by IndexData ApS, <http://www.indexdata.com>
+Copyright (C) 2013-2014 by Index Data ApS, <http://www.indexdata.com>