From d3cc7ff3712bf529d9dc1e227de69ffc1d586d6e Mon Sep 17 00:00:00 2001 From: Andy Zhang Date: Thu, 5 Nov 2026 19:23:48 -0800 Subject: [PATCH 1/2] docs: link www.instacloud.com/docs instead of docs.instacloud.com The docs moved off Mintlify to the site. docs.instacloud.com goes away with the Mintlify project, so links point at the new home. Co-Authored-By: Claude Opus 5.5 --- COMPATIBILITY.md | 4 ++-- CONTRIBUTING.md | 2 +- README.md | 2 +- templates/scripts/publish-lib.test.mjs | 2 +- ui/src/lib/quickStart.test.ts | 2 +- ui/src/lib/quickStart.ts | 2 +- 6 files changed, 7 insertions(+), 7 deletions(-) diff --git a/COMPATIBILITY.md b/COMPATIBILITY.md index f358002a..5e17a083 100644 --- a/COMPATIBILITY.md +++ b/COMPATIBILITY.md @@ -8,7 +8,7 @@ against the daemon. Cloud-only concepts return `501` with guidance rather than p Two rows differ by run mode. **Server mode** is a box installed with `install.sh`: a domain, one admin account, `insta_` tokens. **Local mode** is `npm run dev` on your laptop: no auth, no -domain. See [self-hosting](https://docs.instacloud.com/self-hosting/overview). +domain. See [self-hosting](https://www.instacloud.com/docs/self-hosting/overview). ## CLI commands @@ -82,7 +82,7 @@ access, and the daemon does not verify the signed assertion the CLI attaches to The backups API routes answer `501` with a hint that names the documented path, and there is no `insta backup` command yet. Until the backups milestone: `pg_dump "$(insta postgres url)"` per branch, a tar of `vol/` and the Garage directories under the data directory. See -[upgrade and backups](https://docs.instacloud.com/self-hosting/upgrade). +[upgrade and backups](https://www.instacloud.com/docs/self-hosting/upgrade). ## MCP tools diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 9a4edd45..1f0d4ce6 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -153,5 +153,5 @@ Include: OS, Docker + Node versions, the daemon log, and the failing `insta` com ## Docs and plans -- `docs/` is the Mintlify source for https://docs.instacloud.com. Navigation lives in `docs/docs.json`; a page missing from it still builds (reachable by URL, searchable) but does not appear in the sidebar, so list every page you add. `test/docs-lint.test.ts` fails when a page is unlisted. Preview with `cd docs && npx mint dev`. +- `docs/` holds the docs pages in Mintlify format. The published docs at https://www.instacloud.com/docs are built from `content/docs/` in `InsForge/instacloud-landing`. Navigation lives in `docs/docs.json`; a page missing from it still builds (reachable by URL, searchable) but does not appear in the sidebar, so list every page you add. `test/docs-lint.test.ts` fails when a page is unlisted. Preview with `cd docs && npx mint dev`. - Internal planning notes live in `plans/`, not under `docs/`. diff --git a/README.md b/README.md index ccbbc5f9..114395d5 100644 --- a/README.md +++ b/README.md @@ -128,7 +128,7 @@ immediately. Apps land on `https://--.` and data `pg---.:5432`. Full details, including firewalls, reflinks and your own domain: -[docs.instacloud.com/self-hosting](https://docs.instacloud.com/self-hosting/overview). +[www.instacloud.com/docs/self-hosting](https://www.instacloud.com/docs/self-hosting/overview). ## Deploy from GitHub diff --git a/templates/scripts/publish-lib.test.mjs b/templates/scripts/publish-lib.test.mjs index fa1a0a3c..0e70d8d4 100644 --- a/templates/scripts/publish-lib.test.mjs +++ b/templates/scripts/publish-lib.test.mjs @@ -179,7 +179,7 @@ describe('stripDeployBadge', () => { }) it('does not touch an unrelated image or link', () => { - const text = `# n8n\n\n![shot](./shot.png)\n\n[docs](https://docs.instacloud.com/)\n` + const text = `# n8n\n\n![shot](./shot.png)\n\n[docs](https://www.instacloud.com/docs/)\n` expect(stripDeployBadge(text)).toBe(text) }) diff --git a/ui/src/lib/quickStart.test.ts b/ui/src/lib/quickStart.test.ts index 297f817e..2692f9ee 100644 --- a/ui/src/lib/quickStart.test.ts +++ b/ui/src/lib/quickStart.test.ts @@ -72,7 +72,7 @@ describe('quickStartCards', () => { }) it('reads docs from the self-hosting guide', () => { - expect(DOCS_URL).toBe('https://docs.instacloud.com/self-hosting/overview') + expect(DOCS_URL).toBe('https://www.instacloud.com/docs/self-hosting/overview') }) }) diff --git a/ui/src/lib/quickStart.ts b/ui/src/lib/quickStart.ts index 495e82e6..75379cbe 100644 --- a/ui/src/lib/quickStart.ts +++ b/ui/src/lib/quickStart.ts @@ -17,7 +17,7 @@ import type { RunMode } from './mode' -export const DOCS_URL = 'https://docs.instacloud.com/self-hosting/overview' +export const DOCS_URL = 'https://www.instacloud.com/docs/self-hosting/overview' const INSTALL = 'npm install -g insta' From 4ef0a58655f284fc25985e64a7e394d237a18d08 Mon Sep 17 00:00:00 2001 From: Andy Zhang <16486422+v01dstar@users.noreply.github.com> Date: Fri, 6 Nov 2026 03:29:14 +0000 Subject: [PATCH 2/2] docs: say which docs tree is published in CONTRIBUTING The site builds from instacloud-landing content/docs/, so point doc changes there and describe docs/ here as the unpublished Mintlify copy that docs-lint still checks. Co-Authored-By: andy-bot --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1f0d4ce6..2c4fbc3f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -153,5 +153,5 @@ Include: OS, Docker + Node versions, the daemon log, and the failing `insta` com ## Docs and plans -- `docs/` holds the docs pages in Mintlify format. The published docs at https://www.instacloud.com/docs are built from `content/docs/` in `InsForge/instacloud-landing`. Navigation lives in `docs/docs.json`; a page missing from it still builds (reachable by URL, searchable) but does not appear in the sidebar, so list every page you add. `test/docs-lint.test.ts` fails when a page is unlisted. Preview with `cd docs && npx mint dev`. +- Published docs at https://www.instacloud.com/docs are built from `content/docs/` in `InsForge/instacloud-landing`; changes that should appear on the site go there. This repository's `docs/` tree, the earlier Mintlify source, is no longer published. `test/docs-lint.test.ts` still checks it: navigation lives in `docs/docs.json`, and the test fails when a page is unlisted. Preview it with `cd docs && npx mint dev`. - Internal planning notes live in `plans/`, not under `docs/`.