diff --git a/Makefile b/Makefile index 9f791b5..cf48b40 100644 --- a/Makefile +++ b/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) diff --git a/package-lock.json b/package-lock.json index 6837976..71d6b8c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -10,7 +10,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" }, @@ -171,9 +171,9 @@ } }, "node_modules/@stackql/provider-utils": { - "version": "0.7.10", - "resolved": "https://registry.npmjs.org/@stackql/provider-utils/-/provider-utils-0.7.10.tgz", - "integrity": "sha512-3hlaKT2ce8IaFx0E99ksW0uvmBcQgtfzWAAJz24oSM7bX++6ZrLe87j6CAUyRszowP4FLaO6UMOlHNQzibnViw==", + "version": "0.7.12", + "resolved": "https://registry.npmjs.org/@stackql/provider-utils/-/provider-utils-0.7.12.tgz", + "integrity": "sha512-cwlnLkW/AZ86YVthU/HmVDVlwLHsuJtiCx+w0peqO7t/NpsgLsUneH5vG2PPt+yPv3euZeQg1HeO7NOAgDQdBw==", "license": "MIT", "dependencies": { "@apidevtools/swagger-parser": "^10.1.1", diff --git a/package.json b/package.json index 4a051eb..5291f67 100644 --- a/package.json +++ b/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" }, diff --git a/website/docs/index.md b/website/docs/index.md index 13af7ae..fbe71f3 100644 --- a/website/docs/index.md +++ b/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)__ ::: diff --git a/website/sidebars.js b/website/sidebars.js index f719984..fe6cbb3 100644 --- a/website/sidebars.js +++ b/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', diff --git a/website/src/css/global.css b/website/src/css/global.css index 3e50218..0b80357 100644 --- a/website/src/css/global.css +++ b/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'); } -} \ No newline at end of file +} + +/* +* 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; +}