diff --git a/README.md b/README.md
index 54c4c55..dc673ad 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,24 @@
 ## Getting Started with XOS and CORD
 
-For a general introduction to XOS and how it is used in CORD, see
-http://guide.xosproject.org. The "Developer Guide" at that URL is
-especially helpful, although it isn't perfectly sync'ed with master. 
-Additional design notes, presentations, and other collateral are 
-also available at http://xosproject.org and http://opencord.org.
+XOS is now packaged as a project in the larger CORD open source
+initiative, with source code managed through
+`https://gerrit.opencord.org`. It is also mirrored at:
 
-The best way to get started is to look at the collection of
-canned configurations in `xos/configurations/`. The `cord` 
-configuration in that directory corresponds to our current 
-CORD development environment, and the `README.md` you'll find there
-will help you get started.
+ * `https://github.com/opencord`
+ * `Https://github.com/open-cloud`
 
-Source tree layout:
- * applications -- stand-alone applications that run on top of XOS.
- * containers -- common Dockerfiles used by various XOS configurations
- * views -- mechanisms to extend XOS with customized views
- * xos -- XOS internals
+the latter of which corresponds to the configuration of XOS we run
+on [OpenCloud](http://www.opencloud.us).
+
+Up-to-date information about XOS is available at the [CORD
+Wiki](https://wiki.opencord.org). Additional information is available
+at the original [XOS web site](http://xosproject.org), but it is now
+somewhat dated.
+
+The best way to get started with XOS is to bring up a "Single Node
+CORD POD," as described
+[here](https://wiki.opencord.org/display/CORD/Build+a+CORD+POD). This
+version is configured with a service graph that includes
+`ExampleService`, which is a good platform for understanding how to
+build and use XOS.
+
diff --git a/xos/README.md b/xos/README.md
index daec000..3fcb0fa 100644
--- a/xos/README.md
+++ b/xos/README.md
@@ -2,14 +2,14 @@
 
 This is the main directory for XOS. Sub-directories include:
 
-* configurations -- collection of canned configurations
+* configurations -- deprecated (configurations have moved to the `service-profile` repository)
 * core -- core model definitions
 * generators -- tools to generate auxiliary structures from data model
 * model_policies -- invariants on the data model
 * nginx, uwsgi -- related to web server that runs XOS
 * openstack -- client-side interaction with OpenStack (to be depreciated)
-* services -- model definitions for a set of services
-* synchronizers -- collection of synchronizers
+* services -- now auto-populated by the XOS service on-boarding process
+* synchronizers -- shared synchronizer framework (plus legacy sychnronizers)
 * templates -- Django GUI templates
 * test -- system-wide tests to be collected here
 * tosca -- tosca modeling layer on top of RESTful API
@@ -17,5 +17,7 @@
 * xos -- common source code for all Django applications
 * xos_configuration -- top-level XOS configuration parameters
 
-Of these, configuration, services, and synchronizers are most
-relevant to developers.
+Individual services now live in their own (peer) repository, and XOS
+configuration parameters -- including the service graph to be
+on-boarded into a given deployment -- live in the `service-profile`
+repository.