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

Makefile

@@ -23,6 +23,7 @@ SHELL := bash
 .DEFAULT_GOAL := help
 
 PROVIDER := fivetran
+SOURCE_PROJECT ?= https://github.com/stackql-registry/stackql-provider-$(PROVIDER)
 SERVICES_DIR := provider-dev/openapi/src/$(PROVIDER)
 # The server (https://api.fivetran.com, fixed) is the single source of truth
 # in provider-dev/config/servers.json - shared by bin/split.mjs and this file.
@@ -143,7 +144,8 @@ docs: ## generate the website docs, then sanitize
 	  --provider-name $(PROVIDER) \
 	  --provider-dir ./$(SERVICES_DIR)/v00.00.00000 \
 	  --output-dir ./website \
-	  --provider-data-dir ./provider-dev/docgen/provider-data 	  --snake-case-aliases
+	  --provider-data-dir ./provider-dev/docgen/provider-data 	  --snake-case-aliases \
+	  --source-project $(SOURCE_PROJECT)
 	node website/scripts/sanitize-docs.mjs
 
 website: ## build the docusaurus microsite (vendors shared config first)

package.json

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

website/docs/index.md

@@ -28,6 +28,7 @@ Query, provision and operate Fivetran using SQL - groups and destinations, conne
 
 total services: __15__  
 total resources: __45__  
+source project: __[stackql-provider-fivetran](https://github.com/stackql-registry/stackql-provider-fivetran)__  
 
 :::
 

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;
+}