docs: Merge the feature repo docs pages (#3061)

achals · adchia · commit 42cc91c7c2d7 · 2022-08-10T17:31:40.000-04:00
* docs: Merge the feature repo docs pages

Signed-off-by: Achal Shah &lt;achals@gmail.com&gt;

* delete

Signed-off-by: Achal Shah &lt;achals@gmail.com&gt;

Signed-off-by: Achal Shah &lt;achals@gmail.com&gt;
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
@@ -19,7 +19,6 @@
   * [\[Alpha\] Saved dataset](getting-started/concepts/dataset.md)
 * [Architecture](getting-started/architecture-and-components/README.md)
   * [Overview](getting-started/architecture-and-components/overview.md)
-  * [Feature repository](getting-started/architecture-and-components/feature-repository.md)
   * [Registry](getting-started/architecture-and-components/registry.md)
   * [Offline store](getting-started/architecture-and-components/offline-store.md)
   * [Online store](getting-started/architecture-and-components/online-store.md)
diff --git a/docs/getting-started/architecture-and-components/README.md b/docs/getting-started/architecture-and-components/README.md
@@ -4,10 +4,6 @@
 [overview.md](overview.md)
 {% endcontent-ref %}
 
-{% content-ref url="feature-repository.md" %}
-[feature-repository.md](feature-repository.md)
-{% endcontent-ref %}
-
 {% content-ref url="registry.md" %}
 [registry.md](registry.md)
 {% endcontent-ref %}
diff --git a/docs/getting-started/architecture-and-components/feature-repository.md b/docs/getting-started/architecture-and-components/feature-repository.md
diff --git a/docs/getting-started/concepts/feature-repo.md b/docs/getting-started/concepts/feature-repo.md
@@ -1,13 +1,22 @@
 # Feature Repository
 
-## Feature Repo
+## Feature repository
+Feast users use Feast to manage two important sets of configuration:
+
+* Configuration about how to run Feast on your infrastructure
+* Feature definitions
+
+With Feast, the above configuration can be written declaratively and stored as code in a central location. This central location is called a feature repository. The feature repository is the declarative source of truth for what the desired state of a feature store should be.
 
 A feature repository is the collection of python files that define entities, feature views and data sources. Feature Repos also have a `feature_store.yaml` file at their root. 
 
-Users can collaborate by making and reviewing changes to Feast object definitions (feature views, entities, etc) in the feature repo.
+Users can collaborate by making and reviewing changes to Feast object definitions (feature views, entities, etc.) in the feature repo.
 But, these objects must be applied, either through API, or the CLI, for them to be available by downstream Feast actions (such as materialization, or retrieving online features). Internally, Feast only looks at the registry when performing these actions, and not at the feature repo directly.
 
 ## Declarative Feature Definitions
 
 When using the CLI to apply changes (via `feast apply`), the CLI determines the state of the feature repo from the source files and updates the registry state to reflect the definitions in the feature repo files.
-This means that new feature views are added to the registry, existing feature views are updated as necessary, and Feast objects removed from the source files are deleted from the registry. 
+This means that new feature views are added to the registry, existing feature views are updated as necessary, and Feast objects removed from the source files are deleted from the registry.
+
+For more details, see the [Feature repository](../../reference/feature-repository/) reference.
+
