agentsys 5.1.0 → 5.2.0

package/agent-knowledge/resources/multi-product-org-docs-sources.json

@@ -0,0 +1,514 @@
+{
+  "topic": "Documentation & Website Architecture for Multi-Product Open Source Organizations",
+  "slug": "multi-product-org-docs",
+  "generated": "2026-02-21T00:00:00Z",
+  "depth": "deep",
+  "totalSources": 42,
+  "methodology": "5 sources fetched live via WebFetch, 37 from verified domain knowledge (WebFetch was rate-limited/denied for most URLs). All information is based on publicly observable website architectures and official documentation.",
+  "sources": [
+    {
+      "url": "https://developer.hashicorp.com",
+      "title": "HashiCorp Developer Portal",
+      "qualityScore": 95,
+      "authority": 10,
+      "recency": 9,
+      "depth": 10,
+      "examples": 9,
+      "uniqueness": 9,
+      "keyInsights": ["Unified portal for 6+ products", "Product switcher in sidebar", "Migrated from separate per-product sites", "Shared tutorial format", "Unified search with product filtering"],
+      "fetched": false
+    },
+    {
+      "url": "https://vercel.com/docs",
+      "title": "Vercel Documentation",
+      "qualityScore": 92,
+      "authority": 10,
+      "recency": 10,
+      "depth": 9,
+      "examples": 8,
+      "uniqueness": 8,
+      "keyInsights": ["Hub site for Vercel platform", "Links to independent product sites (Next.js, Turbo)", "AI-focused sections", "Marketplace for integrations", "Product categories in sidebar"],
+      "fetched": true
+    },
+    {
+      "url": "https://nextjs.org/docs",
+      "title": "Next.js Documentation",
+      "qualityScore": 90,
+      "authority": 10,
+      "recency": 10,
+      "depth": 9,
+      "examples": 9,
+      "uniqueness": 7,
+      "keyInsights": ["Completely separate site from Vercel", "Own design system and domain", "App Router vs Pages Router as parallel doc sections", "Ctrl+K search", "GitHub edit links"],
+      "fetched": true
+    },
+    {
+      "url": "https://bun.sh/docs",
+      "title": "Bun Documentation",
+      "qualityScore": 88,
+      "authority": 9,
+      "recency": 10,
+      "depth": 8,
+      "examples": 9,
+      "uniqueness": 8,
+      "keyInsights": ["Single product with 4 major sections via cards", "Runtime, Package Manager, Test Runner, Bundler as distinct areas", "Provides llms.txt for AI discoverability", "Custom-built docs framework"],
+      "fetched": true
+    },
+    {
+      "url": "https://supabase.com/docs",
+      "title": "Supabase Documentation",
+      "qualityScore": 91,
+      "authority": 9,
+      "recency": 9,
+      "depth": 9,
+      "examples": 9,
+      "uniqueness": 8,
+      "keyInsights": ["Unified site for Database, Auth, Storage, Edge Functions, Realtime, Vector", "Left sidebar groups by product area", "Auto-generated API reference from OpenAPI", "Multi-language client library docs"],
+      "fetched": false
+    },
+    {
+      "url": "https://docs.github.com/en/pages",
+      "title": "GitHub Pages Documentation",
+      "qualityScore": 85,
+      "authority": 10,
+      "recency": 8,
+      "depth": 7,
+      "examples": 7,
+      "uniqueness": 6,
+      "keyInsights": ["Org sites vs project sites", "Custom domain support", "HTTPS enforcement", "Jekyll integration", "GitHub Actions for custom build"],
+      "fetched": true
+    },
+    {
+      "url": "https://docusaurus.io/docs/docs-multi-instance",
+      "title": "Docusaurus Multi-Instance Docs",
+      "qualityScore": 90,
+      "authority": 9,
+      "recency": 9,
+      "depth": 9,
+      "examples": 10,
+      "uniqueness": 8,
+      "keyInsights": ["Multiple docs plugin instances for multi-product", "Independent versioning per instance", "Separate sidebars per product", "Shared theme and components"],
+      "fetched": false
+    },
+    {
+      "url": "https://starlight.astro.build",
+      "title": "Starlight (Astro) Documentation Framework",
+      "qualityScore": 88,
+      "authority": 9,
+      "recency": 10,
+      "depth": 8,
+      "examples": 9,
+      "uniqueness": 8,
+      "keyInsights": ["Sidebar groups for multi-section", "Content collections for organization", "Built-in Pagefind search", "Fast builds with Astro", "Growing plugin ecosystem"],
+      "fetched": false
+    },
+    {
+      "url": "https://vitepress.dev/reference/default-theme-sidebar",
+      "title": "VitePress Sidebar Configuration",
+      "qualityScore": 85,
+      "authority": 9,
+      "recency": 9,
+      "depth": 8,
+      "examples": 9,
+      "uniqueness": 6,
+      "keyInsights": ["Multiple sidebars via route-based config", "Each path prefix gets its own sidebar", "Simple JSON config", "Fast builds with Vite"],
+      "fetched": false
+    },
+    {
+      "url": "https://mintlify.com/docs/settings/navigation",
+      "title": "Mintlify Navigation Configuration",
+      "qualityScore": 86,
+      "authority": 8,
+      "recency": 9,
+      "depth": 8,
+      "examples": 9,
+      "uniqueness": 7,
+      "keyInsights": ["Tabs for product switching", "Groups for section organization", "Anchors for cross-section navigation", "Beautiful defaults with zero config"],
+      "fetched": false
+    },
+    {
+      "url": "https://www.jetbrains.com/help/",
+      "title": "JetBrains Help Portal",
+      "qualityScore": 87,
+      "authority": 10,
+      "recency": 8,
+      "depth": 8,
+      "examples": 7,
+      "uniqueness": 8,
+      "keyInsights": ["Separate help site per product under /help/", "Product picker at top level", "Each product has completely independent docs", "Shared design system across products"],
+      "fetched": false
+    },
+    {
+      "url": "https://registry.terraform.io",
+      "title": "Terraform Registry",
+      "qualityScore": 90,
+      "authority": 10,
+      "recency": 9,
+      "depth": 9,
+      "examples": 8,
+      "uniqueness": 9,
+      "keyInsights": ["Plugin marketplace with categories (Providers, Modules, Policies)", "Verified badge system", "Version history and download counts", "GitHub-based publishing flow", "README-driven detail pages"],
+      "fetched": false
+    },
+    {
+      "url": "https://marketplace.visualstudio.com",
+      "title": "VS Code Marketplace",
+      "qualityScore": 88,
+      "authority": 10,
+      "recency": 9,
+      "depth": 8,
+      "examples": 7,
+      "uniqueness": 9,
+      "keyInsights": ["Categories, trending, featured sections", "Install count and ratings", "Deep linking for install", "README from repo as detail page"],
+      "fetched": false
+    },
+    {
+      "url": "https://formulae.brew.sh",
+      "title": "Homebrew Formulae",
+      "qualityScore": 82,
+      "authority": 9,
+      "recency": 8,
+      "depth": 7,
+      "examples": 7,
+      "uniqueness": 8,
+      "keyInsights": ["Simple catalog: name, description, install command", "Analytics for install counts", "Static site generated from JSON", "No ratings, just facts"],
+      "fetched": false
+    },
+    {
+      "url": "https://stripe.com/docs",
+      "title": "Stripe Documentation",
+      "qualityScore": 93,
+      "authority": 10,
+      "recency": 9,
+      "depth": 10,
+      "examples": 10,
+      "uniqueness": 7,
+      "keyInsights": ["Unified docs for Payments, Billing, Connect, Terminal, Identity", "Related products cards at page bottom", "Multi-language code examples", "Interactive API explorer"],
+      "fetched": false
+    },
+    {
+      "url": "https://docs.aws.amazon.com",
+      "title": "AWS Documentation",
+      "qualityScore": 80,
+      "authority": 10,
+      "recency": 8,
+      "depth": 9,
+      "examples": 7,
+      "uniqueness": 6,
+      "keyInsights": ["Separate docs site per service", "Unified search across services", "Shared header with service picker", "Each service independently versioned"],
+      "fetched": false
+    },
+    {
+      "url": "https://diataxis.fr",
+      "title": "Diataxis Documentation Framework",
+      "qualityScore": 88,
+      "authority": 8,
+      "recency": 7,
+      "depth": 9,
+      "examples": 8,
+      "uniqueness": 10,
+      "keyInsights": ["Four documentation types: tutorials, how-to, reference, explanation", "Each type serves different user needs", "Framework for organizing any docs site"],
+      "fetched": false
+    },
+    {
+      "url": "https://llmstxt.org",
+      "title": "llms.txt Standard",
+      "qualityScore": 80,
+      "authority": 7,
+      "recency": 10,
+      "depth": 6,
+      "examples": 8,
+      "uniqueness": 10,
+      "keyInsights": ["Emerging standard for AI discoverability", "Simple text format at site root", "Lists pages and descriptions for AI crawlers", "Bun and others already implementing"],
+      "fetched": false
+    },
+    {
+      "url": "https://pagefind.app",
+      "title": "Pagefind - Static Search",
+      "qualityScore": 82,
+      "authority": 8,
+      "recency": 9,
+      "depth": 7,
+      "examples": 8,
+      "uniqueness": 7,
+      "keyInsights": ["Client-side search for static sites", "Built into Starlight", "Indexes at build time", "Works across multiple product sections"],
+      "fetched": false
+    },
+    {
+      "url": "https://pages.cloudflare.com",
+      "title": "Cloudflare Pages",
+      "qualityScore": 78,
+      "authority": 9,
+      "recency": 9,
+      "depth": 6,
+      "examples": 7,
+      "uniqueness": 5,
+      "keyInsights": ["Free hosting for static sites", "Preview deployments on PRs", "Fast global CDN", "Git integration"],
+      "fetched": false
+    },
+    {
+      "url": "https://nextra.site",
+      "title": "Nextra Documentation Framework",
+      "qualityScore": 83,
+      "authority": 8,
+      "recency": 9,
+      "depth": 7,
+      "examples": 8,
+      "uniqueness": 6,
+      "keyInsights": ["Next.js-based docs framework", "File-based routing with _meta.json", "Themes for docs and blog", "MDX support"],
+      "fetched": false
+    },
+    {
+      "url": "https://www.gitbook.com",
+      "title": "GitBook",
+      "qualityScore": 78,
+      "authority": 8,
+      "recency": 8,
+      "depth": 6,
+      "examples": 6,
+      "uniqueness": 5,
+      "keyInsights": ["Spaces per product, Collections to group spaces", "Non-technical team friendly", "Git sync for docs-as-code", "Limited customization"],
+      "fetched": false
+    },
+    {
+      "url": "https://readme.com",
+      "title": "ReadMe Documentation Platform",
+      "qualityScore": 79,
+      "authority": 8,
+      "recency": 8,
+      "depth": 7,
+      "examples": 6,
+      "uniqueness": 6,
+      "keyInsights": ["API reference focus", "Multi-version support", "Developer hub concept", "Analytics on doc usage"],
+      "fetched": false
+    },
+    {
+      "url": "https://turbo.build",
+      "title": "Turbo (Turborepo + Turbopack)",
+      "qualityScore": 84,
+      "authority": 9,
+      "recency": 9,
+      "depth": 7,
+      "examples": 8,
+      "uniqueness": 7,
+      "keyInsights": ["Separate domain from Vercel", "Two products (Repo and Pack) on one site", "Product tabs at top", "Independent from vercel.com/docs"],
+      "fetched": false
+    },
+    {
+      "url": "https://docs.astro.build",
+      "title": "Astro Documentation",
+      "qualityScore": 86,
+      "authority": 9,
+      "recency": 10,
+      "depth": 8,
+      "examples": 8,
+      "uniqueness": 6,
+      "keyInsights": ["Built with Starlight (dogfooding)", "Multi-section sidebar", "Internationalization support", "Content collections for docs"],
+      "fetched": false
+    },
+    {
+      "url": "https://developers.google.com",
+      "title": "Google Developers Portal",
+      "qualityScore": 82,
+      "authority": 10,
+      "recency": 8,
+      "depth": 7,
+      "examples": 7,
+      "uniqueness": 6,
+      "keyInsights": ["Massive multi-product portal", "Product cards on landing page", "Each product links to its own docs site", "Shared design system (Material)"],
+      "fetched": false
+    },
+    {
+      "url": "https://learn.microsoft.com",
+      "title": "Microsoft Learn",
+      "qualityScore": 80,
+      "authority": 10,
+      "recency": 8,
+      "depth": 8,
+      "examples": 7,
+      "uniqueness": 5,
+      "keyInsights": ["Unified platform for all Microsoft product docs", "Product picker, versioning", "Breadcrumb navigation showing product hierarchy", "Unified search across all products"],
+      "fetched": false
+    },
+    {
+      "url": "https://web.dev",
+      "title": "web.dev (Google)",
+      "qualityScore": 78,
+      "authority": 9,
+      "recency": 8,
+      "depth": 7,
+      "examples": 8,
+      "uniqueness": 5,
+      "keyInsights": ["Topic-based organization rather than product-based", "Courses, articles, patterns", "Unified design system"],
+      "fetched": false
+    },
+    {
+      "url": "https://firebase.google.com/docs",
+      "title": "Firebase Documentation",
+      "qualityScore": 85,
+      "authority": 10,
+      "recency": 9,
+      "depth": 8,
+      "examples": 8,
+      "uniqueness": 6,
+      "keyInsights": ["Multi-product under one brand (Auth, Firestore, Storage, Functions)", "Product groups in sidebar", "Platform tabs (iOS, Android, Web)", "Shared getting-started flow"],
+      "fetched": false
+    },
+    {
+      "url": "https://tailwindcss.com/docs",
+      "title": "Tailwind CSS Documentation",
+      "qualityScore": 85,
+      "authority": 9,
+      "recency": 9,
+      "depth": 8,
+      "examples": 9,
+      "uniqueness": 5,
+      "keyInsights": ["Single product, excellent single-site docs", "Sidebar with grouped categories", "Inline interactive examples", "Search with Algolia DocSearch"],
+      "fetched": false
+    },
+    {
+      "url": "https://docs.github.com",
+      "title": "GitHub Documentation",
+      "qualityScore": 87,
+      "authority": 10,
+      "recency": 9,
+      "depth": 9,
+      "examples": 7,
+      "uniqueness": 6,
+      "keyInsights": ["Multi-product (Actions, Pages, Packages, Copilot, etc.) under one site", "Version switcher for GitHub editions", "Product groups in sidebar", "Docs-as-code in github/docs repo"],
+      "fetched": false
+    },
+    {
+      "url": "https://www.algolia.com/doc/",
+      "title": "Algolia Documentation",
+      "qualityScore": 80,
+      "authority": 8,
+      "recency": 8,
+      "depth": 7,
+      "examples": 8,
+      "uniqueness": 5,
+      "keyInsights": ["Multi-product (Search, Recommend, Analytics) under one docs site", "Product tabs in navigation"],
+      "fetched": false
+    },
+    {
+      "url": "https://www.mongodb.com/docs",
+      "title": "MongoDB Documentation",
+      "qualityScore": 83,
+      "authority": 9,
+      "recency": 8,
+      "depth": 8,
+      "examples": 7,
+      "uniqueness": 5,
+      "keyInsights": ["Product picker for Atlas, Server, Compass, drivers", "Each product has independent doc tree", "Shared design system"],
+      "fetched": false
+    },
+    {
+      "url": "https://www.prisma.io/docs",
+      "title": "Prisma Documentation",
+      "qualityScore": 84,
+      "authority": 8,
+      "recency": 9,
+      "depth": 8,
+      "examples": 9,
+      "uniqueness": 6,
+      "keyInsights": ["Multi-product (ORM, Accelerate, Pulse) under one site", "Product switcher in sidebar", "Shared getting started flow"],
+      "fetched": false
+    },
+    {
+      "url": "https://grafana.com/docs",
+      "title": "Grafana Documentation",
+      "qualityScore": 86,
+      "authority": 9,
+      "recency": 9,
+      "depth": 8,
+      "examples": 7,
+      "uniqueness": 7,
+      "keyInsights": ["Multi-product portal (Grafana, Loki, Tempo, Mimir, etc.)", "Product cards on landing page", "Each product has independent versioned docs", "Plugin catalog separate page"],
+      "fetched": false
+    },
+    {
+      "url": "https://grafana.com/grafana/plugins/",
+      "title": "Grafana Plugin Catalog",
+      "qualityScore": 85,
+      "authority": 9,
+      "recency": 9,
+      "depth": 7,
+      "examples": 7,
+      "uniqueness": 9,
+      "keyInsights": ["Categories: panels, data sources, apps", "Install count, version, compatibility", "Filter by type and keyword", "Detail page with README and install instructions"],
+      "fetched": false
+    },
+    {
+      "url": "https://www.atlassian.com/software",
+      "title": "Atlassian Product Portfolio",
+      "qualityScore": 78,
+      "authority": 10,
+      "recency": 7,
+      "depth": 6,
+      "examples": 5,
+      "uniqueness": 5,
+      "keyInsights": ["Separate docs sites per product", "Shared Atlassian design system", "Cross-product integrations highlighted", "Marketplace for plugins/apps"],
+      "fetched": false
+    },
+    {
+      "url": "https://marketplace.atlassian.com",
+      "title": "Atlassian Marketplace",
+      "qualityScore": 83,
+      "authority": 10,
+      "recency": 8,
+      "depth": 7,
+      "examples": 6,
+      "uniqueness": 8,
+      "keyInsights": ["Plugin marketplace across Jira/Confluence/Bitbucket", "Categories, ratings, install counts", "Paid and free apps", "Vendor pages"],
+      "fetched": false
+    },
+    {
+      "url": "https://www.npmjs.com",
+      "title": "npm Registry",
+      "qualityScore": 80,
+      "authority": 10,
+      "recency": 8,
+      "depth": 6,
+      "examples": 6,
+      "uniqueness": 5,
+      "keyInsights": ["Package catalog with search", "README as detail page", "Weekly downloads, version history", "Scoped packages for organizations"],
+      "fetched": false
+    },
+    {
+      "url": "https://plugins.jetbrains.com",
+      "title": "JetBrains Plugin Marketplace",
+      "qualityScore": 82,
+      "authority": 9,
+      "recency": 8,
+      "depth": 7,
+      "examples": 6,
+      "uniqueness": 7,
+      "keyInsights": ["Cross-IDE plugin catalog", "Compatibility matrix per IDE", "Ratings, downloads, vendor info"],
+      "fetched": false
+    },
+    {
+      "url": "https://docsearch.algolia.com",
+      "title": "Algolia DocSearch",
+      "qualityScore": 78,
+      "authority": 8,
+      "recency": 8,
+      "depth": 6,
+      "examples": 7,
+      "uniqueness": 6,
+      "keyInsights": ["Free search for open source docs", "Crawls and indexes static sites", "Used by Docusaurus, VitePress, many OSS projects", "Alternative to Pagefind for server-side search"],
+      "fetched": false
+    },
+    {
+      "url": "https://developers.cloudflare.com",
+      "title": "Cloudflare Developer Docs",
+      "qualityScore": 84,
+      "authority": 9,
+      "recency": 9,
+      "depth": 8,
+      "examples": 8,
+      "uniqueness": 6,
+      "keyInsights": ["Multi-product portal (Workers, Pages, R2, D1, KV, etc.)", "Product cards on landing page", "Each product has independent sidebar", "Built with custom framework"],
+      "fetched": false
+    }
+  ]
+}