Rework discussion.

[mkws-moved-to-github.git] / doc / mkws-developer.markdown

diff --git a/doc/mkws-developer.markdown b/doc/mkws-developer.markdown
index 7f35917..a299eeb 100644 (file)
--- a/doc/mkws-developer.markdown
+++ b/doc/mkws-developer.markdown
@@ -221,9 +221,6 @@ be used by the derived widget.
        widgets such as `Records` and `Facet` that display some part
        of a search result.
 
-* `expandValue()` --
-       FIXME: 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
@@ -232,20 +229,15 @@ be used by the derived widget.
        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. FIXME: rename this
-       widget and everything related to it.
+       hashes: the latter is optional. This can be used to assemble
+       compound widgets containing several subwidgets.
 
 In addition to these properties and methods of the bare widget object,
 some kinds of specific widget add other properties of their own. For
-example, the `Builder` widget uses a `callback` property as the
+example, the `builder` widget uses a `callback` property as the
 function that it use to publish the widget definition that it
 constructs. This defaults to the builtin function `alert`, but can be
-overridden by derived widgets such as `ConsoleBuilder`.
+overridden by derived widgets such as `console-builder`.
 
 
 Team methods