New guide on versioning

[riverma]

Purpose

• Resolve issue [New Best Practice Guide]: Versioning Guide #198 by creating a versioning best practices guide that focuses on semantic versioning
  fundamentals, conventional commits, and the Commitizen tool for automated version management

Proposed Changes

• [ADD] New versioning guide at /docs/guides/software-lifecycle/versioning/README.mdx
• [ADD] Versioning guide entry to slim-registry.json with appropriate tags and Commitizen package asset
• [CHANGE] Pull requests guide versioning section to reference new dedicated guide with key takeaways for PR workflows
• [CHANGE] Change log guide prerequisites to reference new versioning guide
• [REMOVE] Detailed versioning content from pull-requests guide (ported to new dedicated guide)

Issues

• Resolves [New Best Practice Guide]: Versioning Guide #198

Testing

• Viewed new guide in local rendering
• Verified site builds using yarn build

[riverma]

@anilnatha - what do you think? I made a new recommendation for the commitizen tool in this guide, which I think can help developers use conventional commits (useful for future automated releases). Also, pointed your existing Pull Request guide's versioning section to this guide.

[nutjob4life]

A mermaid chart? Awesome! 🎉

[riverma]

Yes! Here's a rendering for those interested:

graph TD
    A[Start Project] --> B[Install Commitizen]
    B --> C[Run cz init]
    
    C --> F{Making Changes}
    F --> G[cz commit]
    G --> H[Push to Branch]
    H --> I[Create Pull Request]
    I --> J[Review Commits]
    J --> K{Ready to Release?}
    
    K -->|No| F
    K -->|Yes| L[cz bump]
    L --> M[Update CHANGELOG.md]
    M --> N[Mark Release]
    N --> P[CI/CD Pipeline]
    P --> Q[Release Published]
    Q --> F

Loading

[nutjob4life]

LGTM! Nice work @anilnatha and @riverma 👍

[riverma]

LGTM! Nice work @anilnatha and @riverma 👍

Thanks for looking this over @nutjob4life! Appreciate your feedback and 👀 !

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[anilnatha]

These additions are awesome! Thanks for completing these additions.