Updated README for changes introduced in topiccore_refactor

README.md

@@ -30,7 +30,7 @@ Open MCT is now running, and can be accessed by pointing a web browser at [http:
 
 ## Documentation
 
-Documentation is available on the [Open MCT website](https://nasa.github.io/openmct/documentation/). The documentation can also be built locally.
+Documentation is available on the [Open MCT website](https://nasa.github.io/openmct/documentation/).
 
 ### Examples
 
@@ -38,53 +38,29 @@ The clearest examples for developing Open MCT plugins are in the
 [tutorials](https://github.com/nasa/openmct-tutorial) provided in
 our documentation.
 
-Additional examples are available in the `examples` hierarchy of this
-repository; however, be aware that these examples are
-[not fully-documented](https://github.com/nasa/openmct/issues/846), so
-the tutorials will likely serve as a better starting point.
-
 We want Open MCT to be as easy to use, install, run, and develop for as
 possible, and your feedback will help us get there! Feedback can be provided via [GitHub issues](https://github.com/nasa/openmct/issues), or by emailing us at [arc-dl-openmct@mail.nasa.gov](mailto:arc-dl-openmct@mail.nasa.gov).
 
-## Deploying Open MCT
+## Building Applications With Open MCT
 
-Open MCT is built using [`npm`](http://npmjs.com/)
+Open MCT is built using [`npm`](http://npmjs.com/) and [`webpack`](https://webpack.js.org/).
-and [`gulp`](http://gulpjs.com/).
 
-To build Open MCT for deployment:
+See our documentation for a guide on [building Applications with Open MCT](https://github.com/nasa/openmct/blob/master/API.md#starting-an-open-mct-application).
 
-`npm run prepare`
+## Plugins
 
-This will compile and minify JavaScript sources, as well as copy over assets.
+Open MCT can be extended via plugins that make calls to the Open MCT API. A plugin is a group 
-The contents of the `dist` folder will contain a runnable Open MCT
+of software components (including source code and resources such as images and HTML templates)
-instance (e.g. by starting an HTTP server in that directory), including:
+that is intended to be added or removed as a single unit.
 
-* A `main.js` file containing Open MCT source code.
+As well as providing an extension mechanism, most of the core Open MCT codebase is also 
-* Various assets in the `example` and `platform` directories.
+written as plugins.
-* An `index.html` that runs Open MCT in its default configuration.
 
-Additional `gulp` tasks are defined in [the gulpfile](gulpfile.js).
+For information on writing plugins, please see [our API documentation](https://github.com/nasa/openmct/blob/master/API.md#plugins).
-
-## Bundles
-
-A bundle is a group of software components (including source code, declared
-as AMD modules, as well as resources such as images and HTML templates)
-that is intended to be added or removed as a single unit. A plug-in for
-Open MCT will be expressed as a bundle; platform components are also
-expressed as bundles.
-
-A bundle is also just a directory which contains a file `bundle.json`,
-which declares its contents.
-
-The file `bundles.json` (note the plural), at the top level of the
-repository, is a JSON file containing an array of all bundles (expressed as
-directory names) to include in a running instance of Open MCT. Adding or
-removing paths from this list will add or remove bundles from the running
-application.
 
 ## Tests
 
-Tests are written for [Jasmine 1.3](http://jasmine.github.io/1.3/introduction.html)
+Tests are written for [Jasmine 3](https://jasmine.github.io/api/3.1/global)
 and run by [Karma](http://karma-runner.github.io). To run:
 
 `npm test`
@@ -100,7 +76,7 @@ naming convention is otherwise the same.)
 ### Test Reporting
 
 When `npm test` is run, test results will be written as HTML to
-`target/tests`. Code coverage information is written to `target/coverage`.
+`dist/reports/tests/`. Code coverage information is written to `dist/reports/coverage`.
 
 # Glossary
 
@@ -110,11 +86,8 @@ addressed (either by updating this glossary or changing code to reflect
 correct usage.) Other developer documentation, particularly in-line
 documentation, may presume an understanding of these terms.
 
-* _bundle_: A bundle is a removable, reusable grouping of software elements.
+* _plugin_: A plugin is a removable, reusable grouping of software elements.
-  The application is composed of bundles. Plug-ins are bundles. For more
+  The application is composed of plugins.
-  information, refer to framework documentation (under `platform/framework`.)
-* _capability_: An object which exposes dynamic behavior or non-persistent
-  state associated with a domain object.
 * _composition_: In the context of a domain object, this refers to the set of
   other domain objects that compose or are contained by that object. A domain
   object's composition is the set of domain objects that should appear
@@ -129,13 +102,8 @@ documentation, may presume an understanding of these terms.
 * _domain object_: A meaningful object to the user; a distinct thing in
   the work support by Open MCT. Anything that appears in the left-hand
   tree is a domain object.
-* _extension_: An extension is a unit of functionality exposed to the
+* _identifier_: A tuple consisting of a namespace and a key, which together uniquely
-  platform in a declarative fashion by a bundle. For more
+  identifies a domain object.
-  information, refer to framework documentation (under `platform/framework`.)
-* _id_: A string which uniquely identifies a domain object.
-* _key_: When used as an object property, this refers to the machine-readable
-  identifier for a specific thing in a set of things. (Most often used in the
-  context of extensions or other similar application-specific object sets.)
 * _model_: The persistent state associated with a domain object. A domain
   object's model is a JavaScript object which can be converted to JSON
   without losing information (that is, it contains no methods.)
@@ -147,7 +115,5 @@ documentation, may presume an understanding of these terms.
   a user clicks on a domain object in the tree, they are _navigating_ to
   it, and it is thereafter considered the _navigated_ object (until the
   user makes another such choice.)
-* _space_: A name used to identify a persistence store. Interactions with
+* _namespace_: A name used to identify a persistence store. A running open MCT 
-  persistence will generally involve a `space` parameter in some form, to
+application could potentially use multiple persistence stores, with the 
-  distinguish multiple persistence stores from one another (for cases
-  where there are multiple valid persistence locations available.)