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.
 
        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
 * `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
        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
 
 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
 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
 
 
 Team methods