feat: add production write access documentation

[samseely]

Summary

Add comprehensive documentation for the new production write access feature, which enables direct editing of workflows and guides in production when enabled.

Changes

Core concept pages (authoritative sources)

• environments.mdx: Added comprehensive "Production write access" section explaining:

  • How the feature works
  • Affected resource types (workflows, guides)
  • Origin environment protection with examples
  • Decision framework for when to enable vs continue using promotion
  • How to enable in Settings > Permissions
  • Working with both models simultaneously

• commits.mdx: Added "Origin environment and editing restrictions" section covering:

  • How origin environment works
  • Development-originated vs production-originated resources
  • Visual indicators in the dashboard
  • Use cases for both models
  • Warning that origin cannot be changed

Access control

• roles-and-permissions.mdx:
  • Added Production Member role to overview and permissions matrix
  • Added callouts explaining production write access availability
  • Added "Production write access and roles" section with decision framework

Resource-specific pages

• workflows.mdx: Updated callouts about editing restrictions and origin environment
• create-guides.mdx: Updated version control and permissions information

Documentation approach

• environments.mdx and commits.mdx are authoritative sources for core concepts
• Other pages reference these sources rather than duplicating content
• Clear decision framework for when to use each model (promotion vs direct editing)
• Emphasizes origin environment protection maintains separation between version-controlled and production-native resources
• Follows Knock's style guide (sentence case, active voice, educate users on WHY)

Validation

✅ Link verification - all cross-references verified
✅ Formatting check - yarn format.check passes
✅ Type check - yarn type-check passes

Preview

Key sections added:

• Production write access: /version-control/environments#production-write-access
• Origin environment: /version-control/commits#origin-environment-and-editing-restrictions
• Production Member role: /manage-your-account/roles-and-permissions#production-write-access-and-roles

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
docs	Ready	Preview, Comment	Jan 14, 2026 3:41am