SEO

shared/interfaces/Catcrafts.Shared-Model.cppm

@@ -111,9 +111,15 @@ export struct PageMeta {
     // schema.org JSON-LD for this page, already serialized. Emitted verbatim
     // inside <script type="application/ld+json"> — inert data, not code, so
     // it does not count against the shop pages' one-executable-script rule.
-    // Set by RenderHome (Organization: who Catcrafts is, versus the two
-    // name-twins) and RenderProduct (Product: what is sold, at which prices —
-    // the same integers the checkout charges).
+    // Set by RenderHome (an @graph of Organization + WebSite: who Catcrafts is
+    // and what this domain is, versus the two name-twins), RenderAbout
+    // (ProfilePage: who the founder is), RenderShop (ItemList: which product
+    // pages exist) and RenderProduct (ProductGroup: what is sold, per colour,
+    // at which prices — the same integers the checkout charges). About and
+    // the offers reference the home page's Organization by @id rather than
+    // restating it — and home's founder references about's Person the same
+    // way — so every page describes one entity; see the identity graph in
+    // RenderHome for why that join carries the weight it does.
     std::string jsonLd;
 };