From 8ec1edcc925842d36e39ef8a51a0a8d840f8222c Mon Sep 17 00:00:00 2001
From: htaubenfeld <htaubenfeld@microsoft.com>
Date: Tue, 24 Jan 2023 15:30:45 -0800
Subject: [PATCH] packages.microsoft.com repo structure info (#4597)

* adding package repo structure info

* minor edits
---
 SUPPORT.md                        |  4 ++--
 toolkit/README.md                 |  1 +
 toolkit/docs/building/building.md | 30 ++++++++++++++++++++++++++++++
 3 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/SUPPORT.md b/SUPPORT.md
index aba08d50a7..5a1e827611 100644
--- a/SUPPORT.md
+++ b/SUPPORT.md
@@ -4,7 +4,7 @@
 
 This project uses [GitHub issues][gh-issue] to [track bugs][gh-bug] and [feature requests][gh-feature]. Please search the existing issues before filing new issues to avoid duplicates. For new topics, file your bug or feature request as a new issue.
 
-For questions about using this project, please look at the [Demo repo for CBL-Mariner][demo] and our [Contributor's Guide][contributor] if you want to work on CBL-Mariner.
+For questions about using this project, please look at the [Tutorials repo for CBL-Mariner][tutorial] and our [Contributor's Guide][contributor] if you want to work on CBL-Mariner.
 
 ## Microsoft Support Policy
 
@@ -13,5 +13,5 @@ Support for CBL-Mariner is limited to the resources listed above.
 [gh-issue]: https://github.com/microsoft/CBL-Mariner/issues/new/choose
 [gh-bug]: https://github.com/microsoft/CBL-Mariner/issues/new?labels=bug
 [gh-feature]: https://github.com/microsoft/CBL-Mariner/issues/new?labels=enhancement
-[demo]: https://github.com/Microsoft/CBL-MarinerDemo
+[tutorial]: https://github.com/Microsoft/CBL-MarinerTutorials
 [contributor]: https://github.com/microsoft/CBL-Mariner/blob/main/CONTRIBUTING.md
diff --git a/toolkit/README.md b/toolkit/README.md
index 7c1b4250e3..2580fda62e 100644
--- a/toolkit/README.md
+++ b/toolkit/README.md
@@ -18,6 +18,7 @@
 - Build CBL-Mariner end-to-end.
 - Advanced building topics.
 - Build parameters and environment variables.
+- packages.microsoft.com repository structure breakdown.
 
 ## [How the Build System Works](docs/how_it_works/0_intro.md)
 
diff --git a/toolkit/docs/building/building.md b/toolkit/docs/building/building.md
index ffe4f6c6f4..03e69b7b87 100644
--- a/toolkit/docs/building/building.md
+++ b/toolkit/docs/building/building.md
@@ -20,6 +20,9 @@
       - [Force Rebuilds](#force-rebuilds)
       - [Ignoring Packages](#ignoring-packages)
       - [Source Hashes](#source-hashes)
+  - [packages.microsoft.com Repository Structure](#packagesmicrosoftcom-repository-structure)
+      - [CBL-Mariner 1.0](#cbl-mariner-10)
+      - [CBL-Mariner 2.0](#cbl-mariner-20)
   - [Keys, Certs, and Remote Sources](#keys-certs-and-remote-sources)
     - [Sources](#sources)
     - [Authentication](#authentication)
@@ -294,6 +297,33 @@ The build system also enforces hash checking for sources when packaging SRPMs. F
 sudo make input-srpms SRPM_FILE_SIGNATURE_HANDLING=update
 ```
 
+### packages.microsoft.com Repository Structure
+
+CBL-Mariner packages are available on [packages.microsoft.com](https://packages.microsoft.com/cbl-mariner/). The CBL-Mariner repositories are divided into major release folders (1.0, 2.0, etc). Each top level folder is subdivided into "preview" and "production" (prod) repositories.
+
+The "preview" and "production" folders are further subdivided into purpose, and then again for architecture. This includes locations for source-rpms.
+
+#### CBL-Mariner 1.0
+
+For CBL-Mariner 1.0, the repositories are structured as follows:
+
+- **Base:** Packages released with CBL-Mariner 1.0.
+- **Update:** Base packages added or updated since CBL-Mariner 1.0's release date.
+- **CoreUI:** Targeted UI related packages.
+- **Extras:** CBL-Mariner 1.0 packages that are built by Microsoft and are closed source.
+- **NVIDIA:** Specially licensed NVIDIA packages.
+- **Microsoft:** Packages built by other, non-CBL-Mariner, Microsoft teams.
+
+#### CBL-Mariner 2.0
+
+For CBL-Mariner 2.0, the repositories are structured as follows:
+
+- **Base:** Packages released with CBL-Mariner 2.0 and their updates.
+- **Extras:** CBL-Mariner 2.0 packages that are built by Microsoft and are closed source
+- **Extended:** CBL-Mariner 2.0 packages that are not considered part of core. Generally, viewed as experimental or for development purposes.
+- **NVIDIA:** Specially licensed NVIDIA packages.
+- **Microsoft:** Packages built by other, non-CBL-Mariner, Microsoft teams.
+
 ## Keys, Certs, and Remote Sources
 
 ### Sources