Skip to content

Create flox-vs-containers-faq.mdx#22

Open
robinbrantley wants to merge 9 commits into
mainfrom
robinbrantley-containers
Open

Create flox-vs-containers-faq.mdx#22
robinbrantley wants to merge 9 commits into
mainfrom
robinbrantley-containers

Conversation

@robinbrantley
Copy link
Copy Markdown

shift the docker contain FAQ from a google doc to a concept page we can utilise more easily for different purposes.

shift the docker contain FAQ from a google doc to a concept page we can utilise more easily for different purposes.
@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 29, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
flox 🟢 Ready View Preview May 29, 2026, 10:04 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

updating titles so we don't have 2 titles at top
@Kaysahni
Copy link
Copy Markdown
Collaborator

Two things here — one mechanical, one structural — flagging together because the fix for the first depends on how we resolve the second.

Mechanical: this new page isn't added to docs.json, so it's currently unreachable from the sidebar (the concepts nav array ends at concepts/flox-vs-containers). docs.json isn't part of this PR's diff so I can't drop a one-click suggestion on it, but the minimum fix is adding the entry:

"concepts/secrets-management",
"concepts/flox-vs-containers",
"concepts/flox-vs-containers-faq"

Structural (worth deciding first): we already have concepts/flox-vs-containers.mdx, titled "Flox vs. container workflows". Adding "Flox vs. Docker Containers: A Comparison FAQ" right beside it leaves us with two very similarly-named pages in the same section — confusing for readers, and it splits our SEO/AEO signal across two URLs competing for the same query.

Suggestion: rather than a second standalone concept page, make this a dedicated FAQ — either its own FAQ page/section, or folded in as an FAQ section under the existing comparison page — so there's one canonical "Flox vs containers" destination and no near-duplicate. Once we pick the shape, the nav entry above follows from it.


<Accordion title="What about Docker's base image vulnerabilities?">

This is a real consideration for some teams. Research from Chainguard and Sysdig has noted that popular base images often ship with significant numbers of CVEs, and that a substantial portion of running containers contain high-risk vulnerabilities. Docker users typically address this through image scanning, patching, and using minimal or hardened base images (like Alpine, distroless, or Chainguard images). Flox's approach is to include only the packages explicitly declared in the manifest, which can reduce the attack surface.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Worth nailing down before this ships: we cite Chainguard and Sysdig research here but link nothing. These docs get referenced externally (and increasingly cited by LLMs), so we should link the actual sources for the CVE / vulnerability stats — that way we can stand behind exactly what we're claiming. If we can't pin a specific source, let's soften to a general statement rather than attribute a precise finding to a named org. Uncited third-party stats are the kind of thing that gets challenged.

@robinbrantley
Copy link
Copy Markdown
Author

Two things here — one mechanical, one structural — flagging together because the fix for the first depends on how we resolve the second.

Mechanical: this new page isn't added to docs.json, so it's currently unreachable from the sidebar (the concepts nav array ends at concepts/flox-vs-containers). docs.json isn't part of this PR's diff so I can't drop a one-click suggestion on it, but the minimum fix is adding the entry:

"concepts/secrets-management",
"concepts/flox-vs-containers",
"concepts/flox-vs-containers-faq"

I intentionally didn't link it to the docs yet as that hadn't been 100% agreed as per the slack thread. If linked, I don't believe it should be added to the sidebar but to the existing container doc.

Structural (worth deciding first): we already have concepts/flox-vs-containers.mdx, titled "Flox vs. container workflows". Adding "Flox vs. Docker Containers: A Comparison FAQ" right beside it leaves us with two very similarly-named pages in the same section — confusing for readers, and it splits our SEO/AEO signal across two URLs competing for the same query.

Suggestion: rather than a second standalone concept page, make this a dedicated FAQ — either its own FAQ page/section, or folded in as an FAQ section under the existing comparison page — so there's one canonical "Flox vs containers" destination and no near-duplicate. Once we pick the shape, the nav entry above follows from it.

Correct, IF linked, my suggestion as per slack was to link it to the existing doc, not have it as an additional standalone doc.

@robinbrantley
Copy link
Copy Markdown
Author

per the slack thread, 2 additional Qs to potentially add to the list:

  • "When should I use Flox instead of Docker?"
  • "When should I use Flox and Docker together?"

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