Skip to content

docs: Add feature flag naming conventions guide #6605

@talissoncosta

Description

@talissoncosta

Summary

Add documentation covering feature flag naming conventions and best practices, including reference to the project-level regex validation setting.

Background

This came up in internal discussion - we have a project setting for enforcing naming conventions via regex, but it's not documented. Additionally, customers frequently ask about naming best practices.

Proposed content

1. Naming conventions best practices

  • Importance of consistent naming (features cannot be renamed after creation)
  • Self-explanatory names that communicate purpose
  • Examples of good vs. bad naming

2. Enforcing naming conventions with regex

  • Reference to Project Settings → General → Feature Name RegEx
  • How to configure regex validation
  • Example regex patterns for common conventions

3. Related: Tag naming conventions

  • Cross-reference to existing tagging documentation

Resources

Location

Suggested: docs/best-practices/naming-conventions.md

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions