Bp docs language tweaks

[codingfrog27]

EDIT: Second pass

• merged why to pick and what you can do into 1 use case section for more consiseness
  • conceptual features are now in expanded intro
• restructered how it works section and included graphic
  • This could potentially be it’s own page
• Pushed future support into its own roadmap section
  • Beware maintenance cost (though This was already present and if anything should be easier to maintain now)

I’ve also reworded the entire thing to be more consise, and hopefully add more clarity. (Ie: before we led with each pod being ephemeral, but we should be clear that our filesystem is still consistent)

Not sure if this was overkill so for the time being Ive also committed a more “fluffy” alternative overview

-----First PR notes Below here -----

Another pass at the BP docs. Still due from our 1.0 release. To bring the language and direction a bit more in line with our release blog post etc.

Changes:

• FAQ: Added questions covering untrusted code execution, cloud sandbox comparisons, data security, performance, and Portals
• Portals docs: Added "What Portals enable" section with concrete use cases (live previews, collaborative workflows, cross-device testing)
• Glossary: Enhanced definitions for Portal, Pod, and BrowserPod API with more technical detail
  Getting started: Minor intro improvements for clarity

[GabrielaReyna]

Overall looks good to me. I would only advice to not abuse the use of bullet points in the overview page. Almost all sections are entirely bullet points, and the lists are long and difficult to read.

I left comments on two of the subsections with potential solutions.

[cloudflare-workers-and-pages]

Deploying labs-browserpod-previews with    Cloudflare Pages

Latest commit:	23cb2bd
Status:	✅  Deploy successful!
Preview URL:	https://1c94a04b.labs-browserpod-previews.pages.dev
Branch Preview URL:	https://bp-docs-language-tweaks.labs-browserpod-previews.pages.dev

View logs

[GabrielaReyna]

Good job, just minor suggested edits and should be good to go.