website: add the Back to StackQL Docs link and the source repo link

Makefile

@@ -46,6 +46,7 @@ SHELL := /bin/bash
 .DEFAULT_GOAL := help
 
 PROVIDER      := sumologic
+SOURCE_PROJECT ?= https://github.com/stackql-registry/stackql-provider-$(PROVIDER)
 VERSION       := v00.00.00000
 SOURCE_DIR    := provider-dev/source
 CONFIG_DIR    := provider-dev/config
@@ -165,7 +166,8 @@ docs: ## generate website/docs (snake_case surface) and sanitize for MDX
 	  --provider-dir ./$(PROVIDER_DIR) \
 	  --output-dir ./$(WEBSITE_DIR) \
 	  --provider-data-dir ./provider-dev/docgen/provider-data \
-	  --snake-case-aliases > /dev/null
+	  --snake-case-aliases \
+	  --source-project $(SOURCE_PROJECT) > /dev/null
 	node $(WEBSITE_DIR)/scripts/sanitize-docs.mjs
 
 docs-build: ## yarn install && yarn build in website/ (vendors the shared Docusaurus config)

package.json

@@ -27,7 +27,7 @@
   "dependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",
     "@stackql/pgwire-lite": "^1.0.2",
-    "@stackql/provider-utils": "^0.7.9",
+    "@stackql/provider-utils": "^0.7.12",
     "js-yaml": "^4.1.0",
     "pluralize": "^8.0.0"
   },

website/docs/index.md

@@ -25,6 +25,7 @@ Query, provision and operate the Sumo Logic platform using SQL - collectors and
 
 total services: __50__  
 total resources: __213__  
+source project: __[stackql-provider-sumologic](https://github.com/stackql-registry/stackql-provider-sumologic)__  
 
 :::
 

website/sidebars.js

@@ -2,6 +2,19 @@ import { providerTitle } from './provider.js';
 
 const sidebars = {
   mainSidebar: [
+    // Way back to the main stackql.io docs, as on the query library site.
+    // '/stackqldocs' is a shared-config redirect route (registered on this
+    // site by the vendored redirects plugin) that forwards to
+    // https://stackql.io/, so the link renders as internal - no external-link
+    // icon - and the broken-link checker validates it. The arrow and the
+    // divider come from the .sidebar-back-link rules in src/css/global.css.
+    {
+      type: 'link',
+      label: 'Back to StackQL Docs',
+      href: '/stackqldocs',
+      className: 'sidebar-back-link',
+    },
+    // '/providers' is likewise a shared redirect, to https://stackql.io/providers.
     { type: 'link', label: 'All Providers', href: '/providers' },
     {
       type: 'category',

website/src/css/global.css

@@ -284,4 +284,24 @@ div:has(> .vhsImage) {
   .navbar__logo img[src$='stackql-registry-logo-white.svg'] {
     content: url('/img/stackql-registry-logo-white-mobile.svg');
   }
-}
+}
+
+/*
+* sidebar: back link to the main stackql.io docs (the first item in
+* sidebars.js). Same treatment as the query library site: bold label,
+* leading arrow drawn here so the label stays plain text, divider below.
+*/
+.sidebar-back-link {
+  border-bottom: 1px solid var(--ifm-color-emphasis-300);
+  padding-bottom: 0.5rem;
+  margin-bottom: 0.5rem !important;
+}
+
+.sidebar-back-link .menu__link {
+  font-weight: 600;
+}
+
+.sidebar-back-link .menu__link::before {
+  content: '\2190';
+  margin-right: 0.5rem;
+}