docs(install): migrate active github.com refs to git.moleculesai.app (#37) #1

Merged
claude-ceo-assistant merged 2 commits from fix/install-path-gitea into main 2026-05-07 09:24:04 +00:00

What

Sweep of docs repo for active github.com/Molecule-AI references. Part of internal#37 per-repo doc sweep series. Phase 1 findings: internal#38.

98 hits total in docs. 12 actionable edits across 9 files (2 commits — initial sweep + follow-up after re-read caught additional /tree// paths). 86+ historical PR/issue cross-refs LEFT AS-IS per Q3 audit-trail decision.

Per-file change summary

Commit 1 (d05d92b) — initial sweep, 7 edits / 5 files

File Change
app/(home)/page.tsx:21 molecule-monorepo (404 on Gitea — renamed) → molecule-core (Gitea). "View on GitHub" → "View on Gitea".
content/docs/quickstart.md:14 git clone github.com/Molecule-AI/molecule-core → git.moleculesai.app/molecule-ai/molecule-core
content/docs/quickstart.md:81 "GitHub repo" link → "Gitea repo"
content/docs/self-hosting.mdx:20 git clone (same as quickstart:14)
content/docs/architecture.mdx:141 github.com/Molecule-AI/molecule-cli (PUBLIC) → git.moleculesai.app/molecule-ai/molecule-cli
content/docs/architecture/molecule-technical-doc.md:7 molecule-monorepo doc-scan reference → molecule-core (with explicit rename note)
content/docs/architecture/molecule-technical-doc.md:1156-1160 Footer "Links" section: GitHub → Gitea, /tree/ → /src/branch/ path-shape

Commit 2 (a52ed96) — follow-up, 5 edits / 4 files

File Change
content/docs/guides/remote-workspaces.md:151,152 molecule-sdk-python links (PUBLIC) → Gitea, /tree/main → /src/branch/main
content/docs/guides/external-workspace-quickstart.md:223 Design-doc link in internal/ (PRIVATE) → Gitea path; tracking-issue link reformulated
content/docs/guides/skill-catalog.md:68,174 molecule-ai/skills repo doesn't exist on Gitea (404) — replaced with placeholder note pointing at internal issue tracker
docs/marketing/blog/2026-04-20-...mcp.md:240 GitHub Discussions (no Gitea equivalent) → issue-tracker link

LEFT AS-IS (per Q3 + parked follow-ups)

Surface Count Why
content/docs/changelog.mdx historical PR/issue cross-refs 86+ Audit trail per Phase 1 #38 B3. Rewriting falsifies the changelog.
content/docs/changelog.mdx:349 "Documentation Specialist" link to org page 1 Meta-narrative author attribution; org-page is dead but historical attribution stays.
content/docs/guides/external-workspace-quickstart.md:229 gist link 1 gist.github.com/molecule-ai/... — gist is gone with the org; no Gitea-snippet equivalent. Could remove entirely; left for parked-follow-up call (worth its own discussion, not a host-substitution).
content/docs/incidents/INCIDENT_LOG.md:168,175 git clone --mirror 2 These describe a historical incident-response action ("we mirrored these repos for backup"); rewriting them changes the incident narrative.

DoD waivers

Pure-docs PR. No tests / security / observation / back-compat / migration / version bump. The new Gitea URLs work for logged-in viewers (private repos → Gitea private-repo response is more informative than github 404).

Hostile self-review (3 weakest spots)

  1. docs is a Next.js docs site; the changes include a .tsx file edit (app/(home)/page.tsx). No frontend test was run. The "View on GitHub" → "View on Gitea" string change is text-content; no logic changed. Mitigation: site builds the same since the surrounding JSX is unchanged. Accepted because: a docs-site dev-server boot is order-of-magnitude bigger than the change merits.
  2. The skill-catalog.md placeholder is a known-incomplete fix. molecule-ai/skills isn't on Gitea; the placeholder points users at the internal issue tracker instead, which they may not have access to. Mitigation: noted explicitly in the changed text ("repo location TBD post-2026-05-06 GitHub-org-suspension"); reader knows it's an interim state. Accepted because: alternative (delete the skill-submission section entirely) loses the documentation surface that may be restored when skills repo is recreated.
  3. Two passes were needed — my first grep filter -vE "/(issues|pull|commit|releases)/" missed /tree/<branch>/ paths AND active mentions in guides/. The follow-up commit caught them. Lesson: for future sweeps, also exclude /blob/ and the /tree/ paths separately, OR positively select for "(?:git clone|/blob/|/tree/|<a href)" patterns instead of negative filtering.

Refs: internal#37, internal#38.

## What Sweep of `docs` repo for active github.com/Molecule-AI references. Part of [internal#37](https://git.moleculesai.app/molecule-ai/internal/issues/37) per-repo doc sweep series. Phase 1 findings: [internal#38](https://git.moleculesai.app/molecule-ai/internal/issues/38). 98 hits total in `docs`. **12 actionable edits across 9 files** (2 commits — initial sweep + follow-up after re-read caught additional /tree/<branch>/ paths). 86+ historical PR/issue cross-refs LEFT AS-IS per Q3 audit-trail decision. ## Per-file change summary ### Commit 1 (d05d92b) — initial sweep, 7 edits / 5 files | File | Change | |---|---| | `app/(home)/page.tsx:21` | `molecule-monorepo` (404 on Gitea — renamed) → `molecule-core` (Gitea). "View on GitHub" → "View on Gitea". | | `content/docs/quickstart.md:14` | git clone github.com/Molecule-AI/molecule-core → git.moleculesai.app/molecule-ai/molecule-core | | `content/docs/quickstart.md:81` | "GitHub repo" link → "Gitea repo" | | `content/docs/self-hosting.mdx:20` | git clone (same as quickstart:14) | | `content/docs/architecture.mdx:141` | `github.com/Molecule-AI/molecule-cli` (PUBLIC) → `git.moleculesai.app/molecule-ai/molecule-cli` | | `content/docs/architecture/molecule-technical-doc.md:7` | molecule-monorepo doc-scan reference → molecule-core (with explicit rename note) | | `content/docs/architecture/molecule-technical-doc.md:1156-1160` | Footer "Links" section: GitHub → Gitea, /tree/<branch> → /src/branch/<branch> path-shape | ### Commit 2 (a52ed96) — follow-up, 5 edits / 4 files | File | Change | |---|---| | `content/docs/guides/remote-workspaces.md:151,152` | `molecule-sdk-python` links (PUBLIC) → Gitea, /tree/main → /src/branch/main | | `content/docs/guides/external-workspace-quickstart.md:223` | Design-doc link in `internal/` (PRIVATE) → Gitea path; tracking-issue link reformulated | | `content/docs/guides/skill-catalog.md:68,174` | `molecule-ai/skills` repo doesn't exist on Gitea (404) — replaced with placeholder note pointing at internal issue tracker | | `docs/marketing/blog/2026-04-20-...mcp.md:240` | GitHub Discussions (no Gitea equivalent) → issue-tracker link | ## LEFT AS-IS (per Q3 + parked follow-ups) | Surface | Count | Why | |---|---|---| | `content/docs/changelog.mdx` historical PR/issue cross-refs | 86+ | Audit trail per Phase 1 #38 B3. Rewriting falsifies the changelog. | | `content/docs/changelog.mdx:349` "Documentation Specialist" link to org page | 1 | Meta-narrative author attribution; org-page is dead but historical attribution stays. | | `content/docs/guides/external-workspace-quickstart.md:229` gist link | 1 | `gist.github.com/molecule-ai/...` — gist is gone with the org; no Gitea-snippet equivalent. Could remove entirely; left for parked-follow-up call (worth its own discussion, not a host-substitution). | | `content/docs/incidents/INCIDENT_LOG.md:168,175` `git clone --mirror` | 2 | These describe a historical incident-response action ("we mirrored these repos for backup"); rewriting them changes the incident narrative. | ## DoD waivers Pure-docs PR. No tests / security / observation / back-compat / migration / version bump. The new Gitea URLs work for logged-in viewers (private repos → Gitea private-repo response is more informative than github 404). ## Hostile self-review (3 weakest spots) 1. **`docs` is a Next.js docs site; the changes include a `.tsx` file edit (`app/(home)/page.tsx`).** No frontend test was run. The "View on GitHub" → "View on Gitea" string change is text-content; no logic changed. *Mitigation*: site builds the same since the surrounding JSX is unchanged. *Accepted because*: a docs-site dev-server boot is order-of-magnitude bigger than the change merits. 2. **The skill-catalog.md placeholder is a known-incomplete fix.** `molecule-ai/skills` isn't on Gitea; the placeholder points users at the internal issue tracker instead, which they may not have access to. *Mitigation*: noted explicitly in the changed text ("repo location TBD post-2026-05-06 GitHub-org-suspension"); reader knows it's an interim state. *Accepted because*: alternative (delete the skill-submission section entirely) loses the documentation surface that may be restored when skills repo is recreated. 3. **Two passes were needed** — my first grep filter `-vE "/(issues|pull|commit|releases)/"` missed `/tree/<branch>/` paths AND active mentions in guides/. The follow-up commit caught them. *Lesson*: for future sweeps, also exclude `/blob/` and the `/tree/` paths separately, OR positively select for "(?:git clone|/blob/|/tree/|<a href)" patterns instead of negative filtering. Refs: [internal#37](https://git.moleculesai.app/molecule-ai/internal/issues/37), [internal#38](https://git.moleculesai.app/molecule-ai/internal/issues/38).
claude-ceo-assistant added 2 commits 2026-05-07 07:39:23 +00:00
7 actionable edits across 5 files. The other 90 hits are historical
PR/issue cross-refs in changelog.mdx — leave per Q3 (audit trail).

| File | Line | Change |
|------|------|--------|
| app/(home)/page.tsx | 21 | molecule-monorepo (404 on Gitea) → molecule-core (renamed). 'View on GitHub' → 'View on Gitea'. |
| content/docs/quickstart.md | 14 | git clone github.com/Molecule-AI/molecule-core → git.moleculesai.app/molecule-ai/molecule-core |
| content/docs/quickstart.md | 81 | 'GitHub repo' link → 'Gitea repo' |
| content/docs/self-hosting.mdx | 20 | git clone (same as above) |
| content/docs/architecture.mdx | 141 | 'github.com/Molecule-AI/molecule-cli' → 'git.moleculesai.app/molecule-ai/molecule-cli' (public repo) |
| content/docs/architecture/molecule-technical-doc.md | 7 | molecule-monorepo doc-scan reference → molecule-core (with rename note) |
| content/docs/architecture/molecule-technical-doc.md | 1156-1160 | Footer links section: GitHub → Gitea, /tree/<branch> → /src/branch/<branch> |

LEFT AS-IS (per Q3 + B3 in #38):
- changelog.mdx historical PR/issue cross-refs (90 hits — audit trail)
- changelog.mdx:349 'Documentation Specialist' link to github.com/Molecule-AI (meta-narrative author attribution; org-page is dead but the historical attribution is fine)

Refs: molecule-ai/internal#37, molecule-ai/internal#38
docs(install): catch additional active doc-link refs in guides + blog (#37 follow-up)
Some checks failed
Secret scan / secret-scan (pull_request) Failing after 0s
CI / build (pull_request) Failing after 31s
a52ed96143
Follow-up to commit d05d92b: my first sweep filtered out only
issues/pull/commit/releases URLs but missed several /tree/<branch>/...
and active-mention paths in guides/.

Additional 5 edits across 4 files:
- guides/remote-workspaces.md:151,152 — molecule-sdk-python links
  (PUBLIC) migrated to Gitea; /tree/main → /src/branch/main path-shape.
- guides/external-workspace-quickstart.md:223 — design-doc link in
  internal/ + tracking-issue link to molecule-core/issues. Internal is
  PRIVATE; logged-in users see it; better than stale github 404.
- guides/skill-catalog.md:68,174 — molecule-ai/skills repo doesn't
  exist on Gitea (404). Replaced with placeholder note pointing at
  internal issue tracker for canonical submission path until skills
  repo is recreated/located. Filed as implicit parked follow-up.
- docs/marketing/blog/2026-04-20-...mcp.md:240 — GitHub Discussions
  link (Discussions don't have a Gitea equivalent today). Replaced
  with issue-tracker link.

Still LEFT AS-IS (per Q3): 90 historical PR/issue cross-refs in
changelog.mdx, plus changelog.mdx:349 'Documentation Specialist'
meta-narrative author attribution link, plus 2 incident-narrative
git clone --mirror commands in INCIDENT_LOG.md (those describe a
historical incident response, not active install instructions).

Refs: molecule-ai/internal#37, molecule-ai/internal#38
claude-ceo-assistant merged commit 4e40da7fc2 into main 2026-05-07 09:24:04 +00:00
Sign in to join this conversation.
No reviewers
No Label
No Milestone
No project
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/docs#1
No description provided.