Skip to content

Latest commit

 

History

History
43 lines (28 loc) · 1.84 KB

CONTRIBUTING.md

File metadata and controls

43 lines (28 loc) · 1.84 KB

Contributing

Branch Naming

  • Use short, clear and descriptive Names: When naming branches, aim for clarity by providing immediate context about their purpose. For example, use names like feature/login or bugfix/navbar-overflow.

  • Use hyphens to separate wordes: Adopt hyphens to separate words in branch names for improved readability. For instance, bugfix/fix-login-issue is easier to understand than bugfix/fixLoginIssue or bugfix/fix_login_issue. Avoid unecessary hyphens (a name like feat/new — login- is not advisable).

  • Use only lowercase alphanumeric characters (a-z, 0–9) along with hyphens.

  • Use Prefixes for organization:

    • feature/: For creating new features.
    • bugfix/: For addressing code bugs, often linked to a specific issue.
    • hotfix/: For fixing critical production bugs.
    • release/: For preparing a new release, handling tasks like final touches and revisions.
    • docs/: For updating, modifying, or correcting documentation.
  • Add ticket Numbers: If your project uses an issue tracking system like Jira or GitHub issues, incorporate the issue token into the branch name for easier tracking. For instance, feature/PROJ-123-footer-links.

Commits messages with Gitmoji

We recommend using Gitmoji to write commit messages. Visit the Gitmoji website for installation information.

You will find all the emojis on the Gitmoji web site, but most commonly used emoji on the Developer Portal repository are:

  • 🎉 to begin a project
  • 🚧 work in progress
  • Documentation related
    • 📝 To add or update documentation
    • ✏️ To fix a typo
  • Code related
    • ✨ to implement a new feature
    • 🐛 to fix a bug
    • 🚸 to improve user experience
    • ♻️ refactor code
    • 🗑️ deprecated code needed to be removed
  • Maintenance related
    • 🔍 improve SEO