[▲ Vercel Community](/) · [Categories](/categories) · [Latest](/latest) · [Top](/top) · [Live](/live)

[Feedback](/c/feedback/8)

# Ambiguous wording in Vercel Preview Environment branch documentation

9 views · 0 likes · 2 posts


Pythonbytheocean (@pythonbytheocean) · 2026-04-01

Hello Vercel team,

Link to documentation: [Environments](https://vercel.com/docs/deployments/environments#preview-environment-pre-production)

Small docs feedback on this sentence:

> “Push a commit to a branch that is not your production branch (commonly main)”

The wording is ambiguous. On first read, “(commonly `main`)” can sound like it refers to the non-production branch, not the production branch.

A clearer version would be:

> “Push a commit to any branch other than your production branch, commonly `main`. For example, create a branch named `preview` or push to an existing feature branch.”

I think that would be easier for beginners to parse correctly.

Thank you.


Pauline P. Narvas (@pawlean) · 2026-04-02

Thank you for this feedback! We’ll get this reviewed by the Docs team.