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

Makefile

@@ -24,6 +24,7 @@ SHELL := bash
 .DEFAULT_GOAL := help
 
 PROVIDER := gitlab
+SOURCE_PROJECT ?= https://github.com/stackql-registry/stackql-provider-$(PROVIDER)
 SERVICES_DIR := provider-dev/openapi/src/$(PROVIDER)
 VENV := .venv
 PY := $(VENV)/bin/python
@@ -122,7 +123,8 @@ docs: ## generate the website docs, then sanitize for MDX v3
 	  --provider-name $(PROVIDER) \
 	  --provider-dir ./$(SERVICES_DIR)/v00.00.00000 \
 	  --output-dir ./website \
-	  --provider-data-dir ./provider-dev/docgen/provider-data
+	  --provider-data-dir ./provider-dev/docgen/provider-data \
+	  --source-project $(SOURCE_PROJECT)
 	node website/scripts/sanitize-docs.mjs
 
 website: ## build the docusaurus microsite (vendors shared config first)

package.json

@@ -1,36 +1,36 @@
-{
-  "name": "stackql-provider-gitlab",
-  "version": "0.1.0",
-  "description": "StackQL provider for GitLab - read-only SQL over the GitLab GraphQL API",
-  "type": "module",
-  "scripts": {
-    "fetch-schema": "bash ./bin/fetch-schema.sh",
-    "build-inventory": "node ./provider-dev/scripts/build_inventory.mjs",
-    "generate-provider": "node ./provider-dev/scripts/generate_provider.mjs",
-    "validate-complexity": "node ./provider-dev/scripts/validate_complexity.mjs",
-    "generate-docs": "node ./node_modules/@stackql/provider-utils/bin/docgen-utils.mjs generate-docs",
-    "sanitize-docs": "node ./website/scripts/sanitize-docs.mjs",
-    "start-server": "bash ./bin/start-server.sh",
-    "stop-server": "bash ./bin/stop-server.sh",
-    "server-status": "bash ./bin/server-status.sh",
-    "test-meta-routes": "node ./bin/test-meta-routes.cjs",
-    "test-offline": "node ./tests/offline_validation.mjs",
-    "test-integration": "node ./tests/integration/run_integration_tests.mjs"
-  },
-  "dependencies": {
-    "@stackql/pgwire-lite": "^1.0.2",
-    "@stackql/provider-utils": "^0.7.10",
-    "graphql": "^17.0.2",
-    "js-yaml": "^5.2.1"
-  },
-  "keywords": [
-    "stackql",
-    "gitlab",
-    "provider",
-    "graphql"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}
+{
+  "name": "stackql-provider-gitlab",
+  "version": "0.1.0",
+  "description": "StackQL provider for GitLab - read-only SQL over the GitLab GraphQL API",
+  "type": "module",
+  "scripts": {
+    "fetch-schema": "bash ./bin/fetch-schema.sh",
+    "build-inventory": "node ./provider-dev/scripts/build_inventory.mjs",
+    "generate-provider": "node ./provider-dev/scripts/generate_provider.mjs",
+    "validate-complexity": "node ./provider-dev/scripts/validate_complexity.mjs",
+    "generate-docs": "node ./node_modules/@stackql/provider-utils/bin/docgen-utils.mjs generate-docs",
+    "sanitize-docs": "node ./website/scripts/sanitize-docs.mjs",
+    "start-server": "bash ./bin/start-server.sh",
+    "stop-server": "bash ./bin/stop-server.sh",
+    "server-status": "bash ./bin/server-status.sh",
+    "test-meta-routes": "node ./bin/test-meta-routes.cjs",
+    "test-offline": "node ./tests/offline_validation.mjs",
+    "test-integration": "node ./tests/integration/run_integration_tests.mjs"
+  },
+  "dependencies": {
+    "@stackql/pgwire-lite": "^1.0.2",
+    "@stackql/provider-utils": "^0.7.12",
+    "graphql": "^17.0.2",
+    "js-yaml": "^5.2.1"
+  },
+  "keywords": [
+    "stackql",
+    "gitlab",
+    "provider",
+    "graphql"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

website/docs/index.md

@@ -23,6 +23,7 @@ A read-only SQL layer over the GitLab control plane, built on the GitLab GraphQL
 
 total services: __18__  
 total resources: __244__  
+source project: __[stackql-provider-gitlab](https://github.com/stackql-registry/stackql-provider-gitlab)__  
 
 :::
 

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