2 files changed, 18 insertions, 15 deletions

diff --git a/ui/README.chromium b/ui/README.chromium
index 3279ad9..1824944 100644
--- a/ui/README.chromium
+++ b/ui/README.chromium
@@ -1,16 +1,6 @@
-This directory contains elements of Chromium's user interface toolkit:

+This directory contains discrete components used to build Chromium's user

+interface.

 

-base/

-  Common UI framework components for resource loading, localization,

-  string formatting, cross platform model interfaces etc.

-views/

-  UI "View" framework used for building interfaces on Windows and Linux

-  (ChromeOS).

-

-This directory is NOT for things that are unrelated to a user interface library,

-even if:

-* they are shared by multiple top level directories in src/,

-* brettw won't let you put them in base!

-* it's just two little files... come on!

-

-- ben@chromium.org

+Each subdirectory must be an isolated component that lists its dependencies in

+a DEPS file. See subdirectory README.chromium files for specific information

+about each component.

diff --git a/ui/base/README.chromium b/ui/base/README.chromium
new file mode 100644
index 0000000..b887ddb
--- /dev/null
+++ b/ui/base/README.chromium
@@ -0,0 +1,13 @@
+The best description for the role of this component I can come up with is:
+
+Random utilities for building UIs.
+
+... that's kind of sad, since I like components that are focused on specific
+purposes, but there always seems to be one of these gathering places in a
+project and this is it. Specifically, code seems to be added here because it's
+needed by more than one toplevel directory.
+
+Over time, we should shrink this component and move focused, related items out
+into separate components under src/ui (see previous examples in ui/gfx and
+ui/events).
+