More documentation updates

Author: pont-us

docs/images/property-inspector.png

@@ -25,6 +25,8 @@ You can define as many parameters as you like in the property cell. The
 values you assign to them will be used as the default values for these
 parameters when xcengine generates the Application Package.
 
+This tagging convention is similar to the one used by [papermill](https://papermill.readthedocs.io/).
+
 ## Configuring xcengine
 
 As well as parameters, the parameters cell can contain an **xcengine

docs/notebook.md

@@ -1,31 +1,27 @@
-# Running `xcetool`
-
-xcengine provides a command `xcetool` which converts a Jupyter Python notebook
-to a compute engine. A compute engine consists of:
-
-- A docker container image packaging the notebook code, a Python environment,
-  and an [xcube](https://xcube.readthedocs.io/) server component, letting
-  the notebook results be served over multiple supported APIs and explored
-  in the interactive xcube viewer.
-- An accompanying CWL file defining an OGC
-  [Earth Observation Application Package](docs.ogc.org/bp/20-089r1.html) using
-  the container image. This lets your notebook code run as part of a processing
-  workflow on any EOAP platform.
-
-In the conversion process, xcengine tries to maximize convenience for the user
-by requiring as little extra configuration and input as possible. Input
-variables and their types can be defined by tagging a notebook cell
-(similarly to [papermill](https://papermill.readthedocs.io/)), and output
-datasets are automatically extracted from the notebook’s environment.
-Some user configuration is unavoidable, but xcengine automates much of the
-boilerplate required to create an EOAP.
+# Running xcengine
+
+## The `xcetool` command
+
+The command-line interface to xcengine is the command `xcetool`, which
+implements multiple subcommands and options for building and running
+container images and Application Packages.
+
+### `xcetool image build`
+
+TODO
+
+### `xcetool image run`
 
 TODO
 
-# Publishing your container image
+###`xcetool make-script` 
 
 TODO
 
-# Deploying your application package
+## Publishing your container image
+
+TODO
 
-TODO
+## Deploying your application package
+
+TODO