Skip to content

Rewrite and publish Networking concept page for rc44#204

Merged
kcmartin merged 15 commits into
mainfrom
feat/networking-rewrite
Jul 8, 2026
Merged

Rewrite and publish Networking concept page for rc44#204
kcmartin merged 15 commits into
mainfrom
feat/networking-rewrite

Conversation

@kcmartin

@kcmartin kcmartin commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

Rewrites the draft Networking page into a concept hub, matching Lifecycle and Persistence, Checkpoints, and Services: explain the model, link out for procedure, don't duplicate what other pages own.

What changed

  • Reframed the ~260-line how-to draft into a ~130-line concept hub: two ways in (Sprite URL, sprite proxy) and one policy governing what goes out.
  • Corrected a real bug: the draft claimed "full network access, nothing restricted." Outbound is actually governed by a DNS-based egress policy. The page now documents the model: allow-list rules, the defaults include, wildcard specificity, REFUSED on denied domains, raw-IP and private-IP blocking, live reload, read-only from inside, changed only via the API.
  • Fixed stale/invalid commands: dropped sprite exec -detachable, sprite ps, and sprite url --public; used current sprite url update --auth and the verified .sprites.dev domain (the draft and working-with-sprites disagreed on .sprites.app).
  • Removed the SDK tabs and the cookbook (dev server, Postgres, multi-service) that duplicated Services and Working with Sprites.
  • Added the URL-vs-proxy distinction table and the sprite exec port auto-forwarding behavior.
  • Linked Connectors as the distinct "reach external APIs with brokered credentials" mechanism, not folded in.
  • Published: draft removed, publishedDate + author set, added to the Concepts sidebar between Lifecycle and Services.

Command detail stays on Working with Sprites and the CLI Commands reference; this page links to both. base-images already links here for egress-policy detail, which this page now owns.

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Preview Deployment

Name URL
Preview https://pr-204-superfly-sprites-docs.fly.dev

Commit: f3fc68f

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Lighthouse Results

URL Performance Accessibility Best Practices SEO
/ 🟠 83 🟢 100 🟢 96 🟢 100
/concepts/networking/ 🟢 97 🟢 100 🟢 100 🟢 100

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

E2E Test Results

✅ Tests success

Ran against: https://pr-204-superfly-sprites-docs.fly.dev

@jbellerb jbellerb left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Only real issue is the deprecation.

Comment thread src/content/docs/concepts/networking.mdx Outdated
Comment thread src/content/docs/concepts/networking.mdx Outdated
Comment thread src/content/docs/concepts/networking.mdx Outdated
@kcmartin kcmartin merged commit b56487e into main Jul 8, 2026
5 checks passed
@kcmartin kcmartin deleted the feat/networking-rewrite branch July 8, 2026 22:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants