Small touchups

Author: Mpdreamz

docs/building-blocks/link-catalog.md

@@ -32,6 +32,7 @@ The Link Catalog contains:
 * Metadata about each Link Index:
   * Last updated timestamp
   * Commit SHA that produced the Link Index
+  * ETAG of the Link Index file
   * URL to the Link Index file
 
 ## Maintenance
@@ -52,17 +53,16 @@ This process ensures the catalog stays in sync with published Link Index files w
 When running `docs-builder assembler clone` or `docs-builder assembler build`:
 
 1. The assembler fetches the Link Catalog
-2. It determines which repositories and versions to clone/build based on the site configuration
+2. It determines which repositories and versions to clone/build based on the [site configuration](../configure/site/index.md)
 3. It uses the commit SHAs from the catalog to clone specific versions
-4. It falls back to the last known good commit if a repository's current state has build failures
 
 ### By documentation builds
 
 During a documentation build:
 
 1. `docs-builder` fetches the Link Catalog
 2. It determines which Link Index files to download for cross-repository validation
-3. It validates all crosslinks against the appropriate Link Index files
+3. It validates all cross-links against the appropriate Link Index files
 
 ## Benefits
 

docs/building-blocks/link-service.md

@@ -4,13 +4,20 @@ navigation_title: Link Service
 
 # Link Service
 
-The **Link Service** is the central location where all [Link Index](link-index.md) files are published and stored.
+The **Link Service** is the central location that stores:
+
+* All [Link Index](link-index.md) files for all the repositories and branches that are published.
+* The [Link Catalog](link-catalog.md), a single JSON file that contains references to all the `Link Index` files. 
+
+We only have one link service today for all public documentation.
+
+* https://elastic-docs-link-index.s3.us-east-2.amazonaws.com/
 
 ## Architecture
 
 The Link Service is implemented as:
 
-* **Storage** - An S3 bucket containing all Link Index files
+* **Storage** - An S3 bucket
 * **CDN** - CloudFront fronting the S3 bucket for fast global access
 * **Access** - Publicly accessible for read operations