Documentation

[Rid]

Hey @flavioheleno,

We're currently linking to the old docker-php docs, I think it's probably time to maintain and update our own docs, as the old ones are really out of date!

I'm looking for a docs site that looks good, is free for open source, and lets us keep markdown files in git which automatically updates the site.

I had an agent do a quick comparison:

Option	Markdown and Git support	Free offering	Trade-off
[Mintlify](https://www.mintlify.com/pricing)	Supports .md and .mdx, with automatic publishing when changes are pushed.	Starter includes a custom domain and five editors. Eligible OSS projects can apply for free Pro.	Looks polished with little setup, though some features require Pro.
[GitBook](https://www.gitbook.com/solutions/open-source)	Syncs Markdown with GitHub or GitLab. Contributors can use pull requests or the browser editor.	Basic public docs are free. The Sponsored plan adds branding and customization.	Useful for people who prefer editing in a browser; the Basic plan has limited customization.
[Astro Starlight](https://starlight.astro.build/) + [GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages)	Supports .md files, with publishing through GitHub Actions.	Free toolkit and free hosting for public repositories.	Good default design and full control, but we'd maintain the build configuration and dependencies.

I'd lean towards Mintlify for ease of setup, or Starlight if we want more control over the site.

Let me know your preference, I can spin up an agent to create a first version we can review, if you're comfortable with that?

[flavioheleno]

Hey @Rid, I have no particular preference here to be honest, so I trust you to pick whatever suits you :)