minor offline review comments

Author: JamesMcDermott

content/en/docs/neo-porch/2_concepts/architectural.md

@@ -54,15 +54,16 @@ aggregation layer. The benefits of this approach are:
 The Porch server serves the primary Kubernetes
 resources required for basic package authoring and lifeycle management, including:
 
+* A `Repository` [custom resource][crds], which supports repository registration.
 * For each package revision (see [Package Revisions]({{% relref "/docs/neo-porch/2_concepts/fundamentals.md#package-revisions" %}})):
   * `PackageRevision` - represents the *metadata* of the package revision stored in a repository.
   * `PackageRevisionResources` - represents the *file contents* of the package revision.
-    {{% alert color="primary" %}}
-  Note that each package revision is represented by both a `PackageRevision` and a `PackageRevisionResources` - each presents
-  a different view (or [representation](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#differing-representations))
-  of the same underlying package revision.
-    {{% /alert %}}
-* A `Repository` [custom resource][crds], which supports repository registration.
+
+{{% alert color="primary" %}}
+Note that each package revision is represented by both a `PackageRevision` and a `PackageRevisionResources` - each presents
+a different view (or [representation](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#differing-representations))
+of the same underlying package revision.
+{{% /alert %}}
 
 The **Porch server** itself includes the following key components:
 

content/en/docs/neo-porch/2_concepts/fundamentals.md

@@ -8,7 +8,7 @@ description: |
 
 ## Core Concepts
 
-Let us introduce some core concepts of Porch's package orchestration:
+This section introduces some core concepts of Porch's package orchestration:
 
 * ***Package***: A package, in Porch, is specifically a [kpt package](https://kpt.dev/) - a collection of related YAML
 files including one or more **[KRM resources][krm]** and a [Kptfile](https://kpt.dev/book/02-concepts/#packages).

content/en/docs/neo-porch/2_concepts/theory.md

@@ -3,8 +3,8 @@ title: "Theoretical Concepts"
 type: docs
 weight: 3
 description: |
-  The principles and theories behind Porch; Porch as "kpt as a service", implementing a "configuration as data" approach
-  to management of kpt packages.
+  The principles and theories behind Porch; Porch as a service which provides kpt workflows, implementing a "configuration as
+  data" approach to management of kpt packages.
 ---
 
 ## Configuration as Data (CaD)