Utilities that read product metadata from `content/index.md`, build the product map used for navigation and context, and help group products for the home page. This README covers purpose, contracts, usage, workflows, testing, and ownership for the `src/products` subject.

* Generate a typed `productMap` keyed by product ID for routing, context middleware, and robots blocking.

* Derive product group data for the homepage hero/cards, with localization support.

* Provide stable product name mappings (e.g., Enterprise Server releases) for rendering and telemetry.

* Excludes: authoring guidance for product content (see `content/`), TOC authoring, and versioning docs (see `src/versions`).

* `lib/all-products.ts`: Reads `content/index.md` frontmatter, builds `productMap` (id, name, href, dir, toc, wip, hidden, versions, external) and `productIds`; mutates later via middleware to add `nameRendered`.

* `lib/get-product-groups.ts`: Builds homepage product group structures; resolves localized names via translated `content/index.md` when present.

* `lib/product-names.ts`: Maps product codes (dotcom, GHES versions) to display names.

* `lib/old-developer-products.json`: Legacy list used for migration/compat checks.

* Tests under `tests/` validate schemas, product map shape, group helpers, and name mappings.

* Source: `content/index.md` frontmatter.

* `children`: array of product IDs (directory names under `content/`).

* `childGroups`: array of groups `{ name, icon?, octicon?, children[] }` for homepage cards; children entries can be product IDs or deeper paths.

* `externalProducts` (optional): map of product IDs to product objects matching `Product` shape; used to surface external docs.

* Product object shape (see `Product` in `lib/all-products.ts`):

* `id`, `name` (title or shortTitle), `href` (first applicable version), `dir`, `toc`, `wip`, `hidden`, `versions` (computed), optional `external`, optional `nameRendered` (added by middleware).

* Localization: For product groups, localized `content/index.md` frontmatter (same keys) is read if available; structure is always taken from English, names can be swapped via `octicon` matching.

* Server context middleware loads `productMap` into `req.context` for routing, version checks, and rendering product names.

* `get-product-groups` is used to render homepage product cards with localized names when available.

* `productMap` drives robots blocking (wip/hidden), nav generation (`get-toc-items`), and page validation (parent product assertions).

* Update `content/index.md` to add or reorder products and product groups; ensure new product directories have `index.md` with frontmatter (`title`/`shortTitle`, `versions`, optional `wip`/`hidden`).

* To add an external product, define it under `externalProducts` in `content/index.md`. External products should include as many `Product` fields as applicable (such as `id`, `name`, `href`), but some fields (like `versions`) may be omitted.

* For localized group names, add translated `content/index.md` with matching `childGroups` and `octicon` keys.

* Full subject tests: `npm test -- src/products/tests`

* Targeted:

* `products.ts` validates `productMap` schema and presence of expected product IDs.

* `get-product-groups.ts` covers group helper mapping and localization.

* `product-names.ts` checks display name mappings.

* Owners: Docs Engineering. Content changes (titles, grouping, product lists) coordinated with docs-content.

* State: KTLO; update when products are added/retired or homepage groups change.