From 1b1d80c759193ed5cc350daebd17ea82d313e339 Mon Sep 17 00:00:00 2001
From: Jennifer Power <barnabei.jennifer@gmail.com>
Date: Thu, 28 Jul 2022 15:43:57 -0400
Subject: [PATCH] docs: adds build workflow to getting started guide

Closes #9

Signed-off-by: Jennifer Power <barnabei.jennifer@gmail.com>
---
 content/docs/quick-start/_index.adoc    | 44 +++++++++++++++++-----
 docs/categories/quickstart/index.xml    | 50 ++++++++++++++++++++-----
 docs/categories/uor/index.xml           | 50 ++++++++++++++++++++-----
 docs/docs/_print/index.html             | 50 ++++++++++++++++++++-----
 docs/docs/quick-start/_print/index.html | 50 ++++++++++++++++++++-----
 docs/docs/quick-start/index.html        | 50 ++++++++++++++++++++-----
 docs/tags/docs/index.xml                | 50 ++++++++++++++++++++-----
 docs/tags/edu/index.xml                 | 50 ++++++++++++++++++++-----
 8 files changed, 322 insertions(+), 72 deletions(-)

diff --git a/content/docs/quick-start/_index.adoc b/content/docs/quick-start/_index.adoc
index 6ca44ba..74baa89 100644
--- a/content/docs/quick-start/_index.adoc
+++ b/content/docs/quick-start/_index.adoc
@@ -101,26 +101,43 @@ uor-workspace
 1 directory, 3 files
 ----
 
-=== Publishing a Collection
+=== Building a Collection
 
-With the desired set of files contained within the `uor-workspace` directory, the next step is to publishing a collection. This process performs three actions:
+With the desired set of files contained within the `uor-workspace` directory, the next step is to build a collection. This process performs three actions:
 
 1. Discovers all content within the workspace
 2. Produces an OCI artifact based on the content of the collection
-3. Publishes the artifact to a remote repository.
+3. Store the artifact in a local build cache. 
+
+The location of the build cache can be set by exporting the environment variable `UOR_CACHE`. The default location is `~/.uor/cache`.
 
-To publish the collection to a remote registry, let's say that an instance of `registry:2` was running on our local machine and there is the desire to publish the collection to `localhost:5000/uor-framework/getting-started:latest`.
+To build and store the collection, let's say there is the desire to eventually publish the collection to `localhost:5000/uor-framework/getting-started:latest`.
 
-Using the `push` subcommand, execute the following to publish the workspace to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary. 
+Using the `build` subcommand, execute the following to build and store the workspace:
 
 [source, shell]
 ----
-$ client push uor-workspace localhost:5000/uor-framework/getting-started:latest
+$ client build uor-workspace localhost:5000/uor-framework/getting-started:latest
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8 
 WARN[0000] reference for unknown type: image/jpeg       
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json 
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest 
+----
+
+Do not be concerned about the `WARN` messages in the output of the _build_ execution. These are being emitted by the underlying link:https://oras.land[ORAS] library to client utilizes.
+
+=== Publishing a Collection
+
+To publish the collection to a remote registry, let's say that an instance of `registry:2` was running on our local machine and there is the desire to publish the stored collection to `localhost:5000/uor-framework/getting-started:latest`.
+
+Using the `push` subcommand, execute the following to publish the stored collection to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary. 
+
+[source, shell]
+----
+$ client push localhost:5000/uor-framework/getting-started:latest
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest 
 ----
 
@@ -311,18 +328,27 @@ EOF
 
 Associating a `DataSetConfiguration` to a collection is achieved when pushing a workspace to a remote registry by specifying the `--dsconfig` flag and referencing the location of the resource.
 
-=== Publishing a Collection With Attributes
+=== Building a Collection With Attributes
 
-Publish a new tag of the collection called `dsconfig` with the additional metadata associated to the content by executing the following command:
+Store a new tag of the collection called `dsconfig` with the additional metadata associated to the content by executing the following command:
 
 [source, shell]
 ----
-$ client push --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
+$ client build --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8 
 WARN[0000] reference for unknown type: image/jpeg       
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json 
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest 
+----
+
+Publish the collection to the remote registry.
+
+[source, shell]
+----
+$ client push localhost:5000/uor-framework/getting-started:dsconfig
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest 
 ----
 
diff --git a/docs/categories/quickstart/index.xml b/docs/categories/quickstart/index.xml
index ef56243..70546e4 100644
--- a/docs/categories/quickstart/index.xml
+++ b/docs/categories/quickstart/index.xml
@@ -163,9 +163,9 @@ uor-workspace
 &lt;/div&gt;
 &lt;/div&gt;
 &lt;div class=&#34;sect2&#34;&gt;
-&lt;h3 id=&#34;_publishing_a_collection&#34;&gt;Publishing a Collection&lt;/h3&gt;
+&lt;h3 id=&#34;_building_a_collection&#34;&gt;Building a Collection&lt;/h3&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;With the desired set of files contained within the &lt;code&gt;uor-workspace&lt;/code&gt; directory, the next step is to publishing a collection. This process performs three actions:&lt;/p&gt;
+&lt;p&gt;With the desired set of files contained within the &lt;code&gt;uor-workspace&lt;/code&gt; directory, the next step is to build a collection. This process performs three actions:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;olist arabic&#34;&gt;
 &lt;ol class=&#34;arabic&#34;&gt;
@@ -176,24 +176,46 @@ uor-workspace
 &lt;p&gt;Produces an OCI artifact based on the content of the collection&lt;/p&gt;
 &lt;/li&gt;
 &lt;li&gt;
-&lt;p&gt;Publishes the artifact to a remote repository.&lt;/p&gt;
+&lt;p&gt;Store the artifact in a local build cache.&lt;/p&gt;
 &lt;/li&gt;
 &lt;/ol&gt;
 &lt;/div&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;To publish the collection to a remote registry, let’s say that an instance of &lt;code&gt;registry:2&lt;/code&gt; was running on our local machine and there is the desire to publish the collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
+&lt;p&gt;The location of the build cache can be set by exporting the environment variable &lt;code&gt;UOR_CACHE&lt;/code&gt;. The default location is &lt;code&gt;~/.uor/cache&lt;/code&gt;.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;To build and store the collection, let’s say there is the desire to eventually publish the collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;Using the &lt;code&gt;push&lt;/code&gt; subcommand, execute the following to publish the workspace to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.&lt;/p&gt;
+&lt;p&gt;Using the &lt;code&gt;build&lt;/code&gt; subcommand, execute the following to build and store the workspace:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;listingblock&#34;&gt;
 &lt;div class=&#34;content&#34;&gt;
-&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push uor-workspace localhost:5000/uor-framework/getting-started:latest
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client build uor-workspace localhost:5000/uor-framework/getting-started:latest
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Do not be concerned about the &lt;code&gt;WARN&lt;/code&gt; messages in the output of the &lt;em&gt;build&lt;/em&gt; execution. These are being emitted by the underlying &lt;a href=&#34;https://oras.land&#34;&gt;ORAS&lt;/a&gt; library to client utilizes.&lt;/p&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;sect2&#34;&gt;
+&lt;h3 id=&#34;_publishing_a_collection&#34;&gt;Publishing a Collection&lt;/h3&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;To publish the collection to a remote registry, let’s say that an instance of &lt;code&gt;registry:2&lt;/code&gt; was running on our local machine and there is the desire to publish the stored collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Using the &lt;code&gt;push&lt;/code&gt; subcommand, execute the following to publish the stored collection to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;listingblock&#34;&gt;
+&lt;div class=&#34;content&#34;&gt;
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push localhost:5000/uor-framework/getting-started:latest
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
 &lt;/div&gt;
 &lt;/div&gt;
@@ -427,18 +449,28 @@ EOF&lt;/code&gt;&lt;/pre&gt;
 &lt;p&gt;Associating a &lt;code&gt;DataSetConfiguration&lt;/code&gt; to a collection is achieved when pushing a workspace to a remote registry by specifying the &lt;code&gt;--dsconfig&lt;/code&gt; flag and referencing the location of the resource.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;sect2&#34;&gt;
-&lt;h3 id=&#34;_publishing_a_collection_with_attributes&#34;&gt;Publishing a Collection With Attributes&lt;/h3&gt;
+&lt;h3 id=&#34;_building_a_collection_with_attributes&#34;&gt;Building a Collection With Attributes&lt;/h3&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;Publish a new tag of the collection called &lt;code&gt;dsconfig&lt;/code&gt; with the additional metadata associated to the content by executing the following command:&lt;/p&gt;
+&lt;p&gt;Store a new tag of the collection called &lt;code&gt;dsconfig&lt;/code&gt; with the additional metadata associated to the content by executing the following command:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;listingblock&#34;&gt;
 &lt;div class=&#34;content&#34;&gt;
-&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client build --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Publish the collection to the remote registry.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;listingblock&#34;&gt;
+&lt;div class=&#34;content&#34;&gt;
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push localhost:5000/uor-framework/getting-started:dsconfig
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
 &lt;/div&gt;
 &lt;/div&gt;
diff --git a/docs/categories/uor/index.xml b/docs/categories/uor/index.xml
index f14d061..59a7419 100644
--- a/docs/categories/uor/index.xml
+++ b/docs/categories/uor/index.xml
@@ -163,9 +163,9 @@ uor-workspace
 &lt;/div&gt;
 &lt;/div&gt;
 &lt;div class=&#34;sect2&#34;&gt;
-&lt;h3 id=&#34;_publishing_a_collection&#34;&gt;Publishing a Collection&lt;/h3&gt;
+&lt;h3 id=&#34;_building_a_collection&#34;&gt;Building a Collection&lt;/h3&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;With the desired set of files contained within the &lt;code&gt;uor-workspace&lt;/code&gt; directory, the next step is to publishing a collection. This process performs three actions:&lt;/p&gt;
+&lt;p&gt;With the desired set of files contained within the &lt;code&gt;uor-workspace&lt;/code&gt; directory, the next step is to build a collection. This process performs three actions:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;olist arabic&#34;&gt;
 &lt;ol class=&#34;arabic&#34;&gt;
@@ -176,24 +176,46 @@ uor-workspace
 &lt;p&gt;Produces an OCI artifact based on the content of the collection&lt;/p&gt;
 &lt;/li&gt;
 &lt;li&gt;
-&lt;p&gt;Publishes the artifact to a remote repository.&lt;/p&gt;
+&lt;p&gt;Store the artifact in a local build cache.&lt;/p&gt;
 &lt;/li&gt;
 &lt;/ol&gt;
 &lt;/div&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;To publish the collection to a remote registry, let’s say that an instance of &lt;code&gt;registry:2&lt;/code&gt; was running on our local machine and there is the desire to publish the collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
+&lt;p&gt;The location of the build cache can be set by exporting the environment variable &lt;code&gt;UOR_CACHE&lt;/code&gt;. The default location is &lt;code&gt;~/.uor/cache&lt;/code&gt;.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;To build and store the collection, let’s say there is the desire to eventually publish the collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;Using the &lt;code&gt;push&lt;/code&gt; subcommand, execute the following to publish the workspace to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.&lt;/p&gt;
+&lt;p&gt;Using the &lt;code&gt;build&lt;/code&gt; subcommand, execute the following to build and store the workspace:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;listingblock&#34;&gt;
 &lt;div class=&#34;content&#34;&gt;
-&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push uor-workspace localhost:5000/uor-framework/getting-started:latest
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client build uor-workspace localhost:5000/uor-framework/getting-started:latest
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Do not be concerned about the &lt;code&gt;WARN&lt;/code&gt; messages in the output of the &lt;em&gt;build&lt;/em&gt; execution. These are being emitted by the underlying &lt;a href=&#34;https://oras.land&#34;&gt;ORAS&lt;/a&gt; library to client utilizes.&lt;/p&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;sect2&#34;&gt;
+&lt;h3 id=&#34;_publishing_a_collection&#34;&gt;Publishing a Collection&lt;/h3&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;To publish the collection to a remote registry, let’s say that an instance of &lt;code&gt;registry:2&lt;/code&gt; was running on our local machine and there is the desire to publish the stored collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Using the &lt;code&gt;push&lt;/code&gt; subcommand, execute the following to publish the stored collection to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;listingblock&#34;&gt;
+&lt;div class=&#34;content&#34;&gt;
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push localhost:5000/uor-framework/getting-started:latest
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
 &lt;/div&gt;
 &lt;/div&gt;
@@ -427,18 +449,28 @@ EOF&lt;/code&gt;&lt;/pre&gt;
 &lt;p&gt;Associating a &lt;code&gt;DataSetConfiguration&lt;/code&gt; to a collection is achieved when pushing a workspace to a remote registry by specifying the &lt;code&gt;--dsconfig&lt;/code&gt; flag and referencing the location of the resource.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;sect2&#34;&gt;
-&lt;h3 id=&#34;_publishing_a_collection_with_attributes&#34;&gt;Publishing a Collection With Attributes&lt;/h3&gt;
+&lt;h3 id=&#34;_building_a_collection_with_attributes&#34;&gt;Building a Collection With Attributes&lt;/h3&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;Publish a new tag of the collection called &lt;code&gt;dsconfig&lt;/code&gt; with the additional metadata associated to the content by executing the following command:&lt;/p&gt;
+&lt;p&gt;Store a new tag of the collection called &lt;code&gt;dsconfig&lt;/code&gt; with the additional metadata associated to the content by executing the following command:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;listingblock&#34;&gt;
 &lt;div class=&#34;content&#34;&gt;
-&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client build --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Publish the collection to the remote registry.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;listingblock&#34;&gt;
+&lt;div class=&#34;content&#34;&gt;
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push localhost:5000/uor-framework/getting-started:dsconfig
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
 &lt;/div&gt;
 &lt;/div&gt;
diff --git a/docs/docs/_print/index.html b/docs/docs/_print/index.html
index c682b1e..cedd138 100644
--- a/docs/docs/_print/index.html
+++ b/docs/docs/_print/index.html
@@ -377,9 +377,9 @@ <h3 id="_assembling_a_collection">Assembling a Collection</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_publishing_a_collection">Publishing a Collection</h3>
+<h3 id="_building_a_collection">Building a Collection</h3>
 <div class="paragraph">
-<p>With the desired set of files contained within the <code>uor-workspace</code> directory, the next step is to publishing a collection. This process performs three actions:</p>
+<p>With the desired set of files contained within the <code>uor-workspace</code> directory, the next step is to build a collection. This process performs three actions:</p>
 </div>
 <div class="olist arabic">
 <ol class="arabic">
@@ -390,24 +390,46 @@ <h3 id="_publishing_a_collection">Publishing a Collection</h3>
 <p>Produces an OCI artifact based on the content of the collection</p>
 </li>
 <li>
-<p>Publishes the artifact to a remote repository.</p>
+<p>Store the artifact in a local build cache.</p>
 </li>
 </ol>
 </div>
 <div class="paragraph">
-<p>To publish the collection to a remote registry, let’s say that an instance of <code>registry:2</code> was running on our local machine and there is the desire to publish the collection to <code>localhost:5000/uor-framework/getting-started:latest</code>.</p>
+<p>The location of the build cache can be set by exporting the environment variable <code>UOR_CACHE</code>. The default location is <code>~/.uor/cache</code>.</p>
+</div>
+<div class="paragraph">
+<p>To build and store the collection, let’s say there is the desire to eventually publish the collection to <code>localhost:5000/uor-framework/getting-started:latest</code>.</p>
 </div>
 <div class="paragraph">
-<p>Using the <code>push</code> subcommand, execute the following to publish the workspace to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.</p>
+<p>Using the <code>build</code> subcommand, execute the following to build and store the workspace:</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push uor-workspace localhost:5000/uor-framework/getting-started:latest
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client build uor-workspace localhost:5000/uor-framework/getting-started:latest
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Do not be concerned about the <code>WARN</code> messages in the output of the <em>build</em> execution. These are being emitted by the underlying <a href="https://oras.land">ORAS</a> library to client utilizes.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_publishing_a_collection">Publishing a Collection</h3>
+<div class="paragraph">
+<p>To publish the collection to a remote registry, let’s say that an instance of <code>registry:2</code> was running on our local machine and there is the desire to publish the stored collection to <code>localhost:5000/uor-framework/getting-started:latest</code>.</p>
+</div>
+<div class="paragraph">
+<p>Using the <code>push</code> subcommand, execute the following to publish the stored collection to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push localhost:5000/uor-framework/getting-started:latest
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest</code></pre>
 </div>
 </div>
@@ -641,18 +663,28 @@ <h2 id="_user_defined_attributes">User Defined Attributes</h2>
 <p>Associating a <code>DataSetConfiguration</code> to a collection is achieved when pushing a workspace to a remote registry by specifying the <code>--dsconfig</code> flag and referencing the location of the resource.</p>
 </div>
 <div class="sect2">
-<h3 id="_publishing_a_collection_with_attributes">Publishing a Collection With Attributes</h3>
+<h3 id="_building_a_collection_with_attributes">Building a Collection With Attributes</h3>
 <div class="paragraph">
-<p>Publish a new tag of the collection called <code>dsconfig</code> with the additional metadata associated to the content by executing the following command:</p>
+<p>Store a new tag of the collection called <code>dsconfig</code> with the additional metadata associated to the content by executing the following command:</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client build --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Publish the collection to the remote registry.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push localhost:5000/uor-framework/getting-started:dsconfig
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest</code></pre>
 </div>
 </div>
diff --git a/docs/docs/quick-start/_print/index.html b/docs/docs/quick-start/_print/index.html
index b499579..0fc8bba 100644
--- a/docs/docs/quick-start/_print/index.html
+++ b/docs/docs/quick-start/_print/index.html
@@ -288,9 +288,9 @@ <h3 id="_assembling_a_collection">Assembling a Collection</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_publishing_a_collection">Publishing a Collection</h3>
+<h3 id="_building_a_collection">Building a Collection</h3>
 <div class="paragraph">
-<p>With the desired set of files contained within the <code>uor-workspace</code> directory, the next step is to publishing a collection. This process performs three actions:</p>
+<p>With the desired set of files contained within the <code>uor-workspace</code> directory, the next step is to build a collection. This process performs three actions:</p>
 </div>
 <div class="olist arabic">
 <ol class="arabic">
@@ -301,24 +301,46 @@ <h3 id="_publishing_a_collection">Publishing a Collection</h3>
 <p>Produces an OCI artifact based on the content of the collection</p>
 </li>
 <li>
-<p>Publishes the artifact to a remote repository.</p>
+<p>Store the artifact in a local build cache.</p>
 </li>
 </ol>
 </div>
 <div class="paragraph">
-<p>To publish the collection to a remote registry, let’s say that an instance of <code>registry:2</code> was running on our local machine and there is the desire to publish the collection to <code>localhost:5000/uor-framework/getting-started:latest</code>.</p>
+<p>The location of the build cache can be set by exporting the environment variable <code>UOR_CACHE</code>. The default location is <code>~/.uor/cache</code>.</p>
+</div>
+<div class="paragraph">
+<p>To build and store the collection, let’s say there is the desire to eventually publish the collection to <code>localhost:5000/uor-framework/getting-started:latest</code>.</p>
 </div>
 <div class="paragraph">
-<p>Using the <code>push</code> subcommand, execute the following to publish the workspace to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.</p>
+<p>Using the <code>build</code> subcommand, execute the following to build and store the workspace:</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push uor-workspace localhost:5000/uor-framework/getting-started:latest
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client build uor-workspace localhost:5000/uor-framework/getting-started:latest
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Do not be concerned about the <code>WARN</code> messages in the output of the <em>build</em> execution. These are being emitted by the underlying <a href="https://oras.land">ORAS</a> library to client utilizes.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_publishing_a_collection">Publishing a Collection</h3>
+<div class="paragraph">
+<p>To publish the collection to a remote registry, let’s say that an instance of <code>registry:2</code> was running on our local machine and there is the desire to publish the stored collection to <code>localhost:5000/uor-framework/getting-started:latest</code>.</p>
+</div>
+<div class="paragraph">
+<p>Using the <code>push</code> subcommand, execute the following to publish the stored collection to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push localhost:5000/uor-framework/getting-started:latest
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest</code></pre>
 </div>
 </div>
@@ -552,18 +574,28 @@ <h2 id="_user_defined_attributes">User Defined Attributes</h2>
 <p>Associating a <code>DataSetConfiguration</code> to a collection is achieved when pushing a workspace to a remote registry by specifying the <code>--dsconfig</code> flag and referencing the location of the resource.</p>
 </div>
 <div class="sect2">
-<h3 id="_publishing_a_collection_with_attributes">Publishing a Collection With Attributes</h3>
+<h3 id="_building_a_collection_with_attributes">Building a Collection With Attributes</h3>
 <div class="paragraph">
-<p>Publish a new tag of the collection called <code>dsconfig</code> with the additional metadata associated to the content by executing the following command:</p>
+<p>Store a new tag of the collection called <code>dsconfig</code> with the additional metadata associated to the content by executing the following command:</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client build --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Publish the collection to the remote registry.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push localhost:5000/uor-framework/getting-started:dsconfig
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest</code></pre>
 </div>
 </div>
diff --git a/docs/docs/quick-start/index.html b/docs/docs/quick-start/index.html
index a67e202..795c92c 100644
--- a/docs/docs/quick-start/index.html
+++ b/docs/docs/quick-start/index.html
@@ -408,9 +408,9 @@ <h3 id="_assembling_a_collection">Assembling a Collection</h3>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_publishing_a_collection">Publishing a Collection</h3>
+<h3 id="_building_a_collection">Building a Collection</h3>
 <div class="paragraph">
-<p>With the desired set of files contained within the <code>uor-workspace</code> directory, the next step is to publishing a collection. This process performs three actions:</p>
+<p>With the desired set of files contained within the <code>uor-workspace</code> directory, the next step is to build a collection. This process performs three actions:</p>
 </div>
 <div class="olist arabic">
 <ol class="arabic">
@@ -421,24 +421,46 @@ <h3 id="_publishing_a_collection">Publishing a Collection</h3>
 <p>Produces an OCI artifact based on the content of the collection</p>
 </li>
 <li>
-<p>Publishes the artifact to a remote repository.</p>
+<p>Store the artifact in a local build cache.</p>
 </li>
 </ol>
 </div>
 <div class="paragraph">
-<p>To publish the collection to a remote registry, let’s say that an instance of <code>registry:2</code> was running on our local machine and there is the desire to publish the collection to <code>localhost:5000/uor-framework/getting-started:latest</code>.</p>
+<p>The location of the build cache can be set by exporting the environment variable <code>UOR_CACHE</code>. The default location is <code>~/.uor/cache</code>.</p>
+</div>
+<div class="paragraph">
+<p>To build and store the collection, let’s say there is the desire to eventually publish the collection to <code>localhost:5000/uor-framework/getting-started:latest</code>.</p>
 </div>
 <div class="paragraph">
-<p>Using the <code>push</code> subcommand, execute the following to publish the workspace to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.</p>
+<p>Using the <code>build</code> subcommand, execute the following to build and store the workspace:</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push uor-workspace localhost:5000/uor-framework/getting-started:latest
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client build uor-workspace localhost:5000/uor-framework/getting-started:latest
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Do not be concerned about the <code>WARN</code> messages in the output of the <em>build</em> execution. These are being emitted by the underlying <a href="https://oras.land">ORAS</a> library to client utilizes.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_publishing_a_collection">Publishing a Collection</h3>
+<div class="paragraph">
+<p>To publish the collection to a remote registry, let’s say that an instance of <code>registry:2</code> was running on our local machine and there is the desire to publish the stored collection to <code>localhost:5000/uor-framework/getting-started:latest</code>.</p>
+</div>
+<div class="paragraph">
+<p>Using the <code>push</code> subcommand, execute the following to publish the stored collection to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push localhost:5000/uor-framework/getting-started:latest
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest</code></pre>
 </div>
 </div>
@@ -672,18 +694,28 @@ <h2 id="_user_defined_attributes">User Defined Attributes</h2>
 <p>Associating a <code>DataSetConfiguration</code> to a collection is achieved when pushing a workspace to a remote registry by specifying the <code>--dsconfig</code> flag and referencing the location of the resource.</p>
 </div>
 <div class="sect2">
-<h3 id="_publishing_a_collection_with_attributes">Publishing a Collection With Attributes</h3>
+<h3 id="_building_a_collection_with_attributes">Building a Collection With Attributes</h3>
 <div class="paragraph">
-<p>Publish a new tag of the collection called <code>dsconfig</code> with the additional metadata associated to the content by executing the following command:</p>
+<p>Store a new tag of the collection called <code>dsconfig</code> with the additional metadata associated to the content by executing the following command:</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client build --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Publish the collection to the remote registry.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-shell" data-lang="shell">$ client push localhost:5000/uor-framework/getting-started:dsconfig
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest</code></pre>
 </div>
 </div>
diff --git a/docs/tags/docs/index.xml b/docs/tags/docs/index.xml
index 65f5602..33a0833 100644
--- a/docs/tags/docs/index.xml
+++ b/docs/tags/docs/index.xml
@@ -163,9 +163,9 @@ uor-workspace
 &lt;/div&gt;
 &lt;/div&gt;
 &lt;div class=&#34;sect2&#34;&gt;
-&lt;h3 id=&#34;_publishing_a_collection&#34;&gt;Publishing a Collection&lt;/h3&gt;
+&lt;h3 id=&#34;_building_a_collection&#34;&gt;Building a Collection&lt;/h3&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;With the desired set of files contained within the &lt;code&gt;uor-workspace&lt;/code&gt; directory, the next step is to publishing a collection. This process performs three actions:&lt;/p&gt;
+&lt;p&gt;With the desired set of files contained within the &lt;code&gt;uor-workspace&lt;/code&gt; directory, the next step is to build a collection. This process performs three actions:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;olist arabic&#34;&gt;
 &lt;ol class=&#34;arabic&#34;&gt;
@@ -176,24 +176,46 @@ uor-workspace
 &lt;p&gt;Produces an OCI artifact based on the content of the collection&lt;/p&gt;
 &lt;/li&gt;
 &lt;li&gt;
-&lt;p&gt;Publishes the artifact to a remote repository.&lt;/p&gt;
+&lt;p&gt;Store the artifact in a local build cache.&lt;/p&gt;
 &lt;/li&gt;
 &lt;/ol&gt;
 &lt;/div&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;To publish the collection to a remote registry, let’s say that an instance of &lt;code&gt;registry:2&lt;/code&gt; was running on our local machine and there is the desire to publish the collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
+&lt;p&gt;The location of the build cache can be set by exporting the environment variable &lt;code&gt;UOR_CACHE&lt;/code&gt;. The default location is &lt;code&gt;~/.uor/cache&lt;/code&gt;.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;To build and store the collection, let’s say there is the desire to eventually publish the collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;Using the &lt;code&gt;push&lt;/code&gt; subcommand, execute the following to publish the workspace to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.&lt;/p&gt;
+&lt;p&gt;Using the &lt;code&gt;build&lt;/code&gt; subcommand, execute the following to build and store the workspace:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;listingblock&#34;&gt;
 &lt;div class=&#34;content&#34;&gt;
-&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push uor-workspace localhost:5000/uor-framework/getting-started:latest
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client build uor-workspace localhost:5000/uor-framework/getting-started:latest
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Do not be concerned about the &lt;code&gt;WARN&lt;/code&gt; messages in the output of the &lt;em&gt;build&lt;/em&gt; execution. These are being emitted by the underlying &lt;a href=&#34;https://oras.land&#34;&gt;ORAS&lt;/a&gt; library to client utilizes.&lt;/p&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;sect2&#34;&gt;
+&lt;h3 id=&#34;_publishing_a_collection&#34;&gt;Publishing a Collection&lt;/h3&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;To publish the collection to a remote registry, let’s say that an instance of &lt;code&gt;registry:2&lt;/code&gt; was running on our local machine and there is the desire to publish the stored collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Using the &lt;code&gt;push&lt;/code&gt; subcommand, execute the following to publish the stored collection to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;listingblock&#34;&gt;
+&lt;div class=&#34;content&#34;&gt;
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push localhost:5000/uor-framework/getting-started:latest
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
 &lt;/div&gt;
 &lt;/div&gt;
@@ -427,18 +449,28 @@ EOF&lt;/code&gt;&lt;/pre&gt;
 &lt;p&gt;Associating a &lt;code&gt;DataSetConfiguration&lt;/code&gt; to a collection is achieved when pushing a workspace to a remote registry by specifying the &lt;code&gt;--dsconfig&lt;/code&gt; flag and referencing the location of the resource.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;sect2&#34;&gt;
-&lt;h3 id=&#34;_publishing_a_collection_with_attributes&#34;&gt;Publishing a Collection With Attributes&lt;/h3&gt;
+&lt;h3 id=&#34;_building_a_collection_with_attributes&#34;&gt;Building a Collection With Attributes&lt;/h3&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;Publish a new tag of the collection called &lt;code&gt;dsconfig&lt;/code&gt; with the additional metadata associated to the content by executing the following command:&lt;/p&gt;
+&lt;p&gt;Store a new tag of the collection called &lt;code&gt;dsconfig&lt;/code&gt; with the additional metadata associated to the content by executing the following command:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;listingblock&#34;&gt;
 &lt;div class=&#34;content&#34;&gt;
-&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client build --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Publish the collection to the remote registry.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;listingblock&#34;&gt;
+&lt;div class=&#34;content&#34;&gt;
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push localhost:5000/uor-framework/getting-started:dsconfig
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
 &lt;/div&gt;
 &lt;/div&gt;
diff --git a/docs/tags/edu/index.xml b/docs/tags/edu/index.xml
index 52e78e5..990a024 100644
--- a/docs/tags/edu/index.xml
+++ b/docs/tags/edu/index.xml
@@ -163,9 +163,9 @@ uor-workspace
 &lt;/div&gt;
 &lt;/div&gt;
 &lt;div class=&#34;sect2&#34;&gt;
-&lt;h3 id=&#34;_publishing_a_collection&#34;&gt;Publishing a Collection&lt;/h3&gt;
+&lt;h3 id=&#34;_building_a_collection&#34;&gt;Building a Collection&lt;/h3&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;With the desired set of files contained within the &lt;code&gt;uor-workspace&lt;/code&gt; directory, the next step is to publishing a collection. This process performs three actions:&lt;/p&gt;
+&lt;p&gt;With the desired set of files contained within the &lt;code&gt;uor-workspace&lt;/code&gt; directory, the next step is to build a collection. This process performs three actions:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;olist arabic&#34;&gt;
 &lt;ol class=&#34;arabic&#34;&gt;
@@ -176,24 +176,46 @@ uor-workspace
 &lt;p&gt;Produces an OCI artifact based on the content of the collection&lt;/p&gt;
 &lt;/li&gt;
 &lt;li&gt;
-&lt;p&gt;Publishes the artifact to a remote repository.&lt;/p&gt;
+&lt;p&gt;Store the artifact in a local build cache.&lt;/p&gt;
 &lt;/li&gt;
 &lt;/ol&gt;
 &lt;/div&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;To publish the collection to a remote registry, let’s say that an instance of &lt;code&gt;registry:2&lt;/code&gt; was running on our local machine and there is the desire to publish the collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
+&lt;p&gt;The location of the build cache can be set by exporting the environment variable &lt;code&gt;UOR_CACHE&lt;/code&gt;. The default location is &lt;code&gt;~/.uor/cache&lt;/code&gt;.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;To build and store the collection, let’s say there is the desire to eventually publish the collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;Using the &lt;code&gt;push&lt;/code&gt; subcommand, execute the following to publish the workspace to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.&lt;/p&gt;
+&lt;p&gt;Using the &lt;code&gt;build&lt;/code&gt; subcommand, execute the following to build and store the workspace:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;listingblock&#34;&gt;
 &lt;div class=&#34;content&#34;&gt;
-&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push uor-workspace localhost:5000/uor-framework/getting-started:latest
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client build uor-workspace localhost:5000/uor-framework/getting-started:latest
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Do not be concerned about the &lt;code&gt;WARN&lt;/code&gt; messages in the output of the &lt;em&gt;build&lt;/em&gt; execution. These are being emitted by the underlying &lt;a href=&#34;https://oras.land&#34;&gt;ORAS&lt;/a&gt; library to client utilizes.&lt;/p&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;sect2&#34;&gt;
+&lt;h3 id=&#34;_publishing_a_collection&#34;&gt;Publishing a Collection&lt;/h3&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;To publish the collection to a remote registry, let’s say that an instance of &lt;code&gt;registry:2&lt;/code&gt; was running on our local machine and there is the desire to publish the stored collection to &lt;code&gt;localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Using the &lt;code&gt;push&lt;/code&gt; subcommand, execute the following to publish the stored collection to a remote registry. Additional options are also available for specifying the location of a file containing authentication details or communicating with an insecure or HTTP based registry if necessary.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;listingblock&#34;&gt;
+&lt;div class=&#34;content&#34;&gt;
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push localhost:5000/uor-framework/getting-started:latest
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
 &lt;/div&gt;
 &lt;/div&gt;
@@ -427,18 +449,28 @@ EOF&lt;/code&gt;&lt;/pre&gt;
 &lt;p&gt;Associating a &lt;code&gt;DataSetConfiguration&lt;/code&gt; to a collection is achieved when pushing a workspace to a remote registry by specifying the &lt;code&gt;--dsconfig&lt;/code&gt; flag and referencing the location of the resource.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;sect2&#34;&gt;
-&lt;h3 id=&#34;_publishing_a_collection_with_attributes&#34;&gt;Publishing a Collection With Attributes&lt;/h3&gt;
+&lt;h3 id=&#34;_building_a_collection_with_attributes&#34;&gt;Building a Collection With Attributes&lt;/h3&gt;
 &lt;div class=&#34;paragraph&#34;&gt;
-&lt;p&gt;Publish a new tag of the collection called &lt;code&gt;dsconfig&lt;/code&gt; with the additional metadata associated to the content by executing the following command:&lt;/p&gt;
+&lt;p&gt;Store a new tag of the collection called &lt;code&gt;dsconfig&lt;/code&gt; with the additional metadata associated to the content by executing the following command:&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class=&#34;listingblock&#34;&gt;
 &lt;div class=&#34;content&#34;&gt;
-&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client build --dsconfig=dataset-configuration.yaml uor-workspace localhost:5000/uor-framework/getting-started:dsconfig
 
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: text/plain; charset=utf-8
 WARN[0000] reference for unknown type: image/jpeg
 WARN[0000] reference for unknown type: application/vnd.uor.config.v1+json
+INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 built with reference name localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class=&#34;paragraph&#34;&gt;
+&lt;p&gt;Publish the collection to the remote registry.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class=&#34;listingblock&#34;&gt;
+&lt;div class=&#34;content&#34;&gt;
+&lt;pre class=&#34;highlight&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;$ client push localhost:5000/uor-framework/getting-started:dsconfig
+
 INFO[0000] Artifact sha256:43c520531d3c1f2dbebb82aaa1e55d19040075772bcdf44db32561eea73c76e9 published to localhost:5000/uor-framework/getting-started:latest&lt;/code&gt;&lt;/pre&gt;
 &lt;/div&gt;
 &lt;/div&gt;