Skip to content

Conversation

@Zdonuk
Copy link

@Zdonuk Zdonuk commented Oct 28, 2025

📋 Summary

This PR transforms CONTRIBUTING.md from a basic 300-word document into a comprehensive 3,100-word contribution guide following industry best practices.

🎯 Motivation

The current CONTRIBUTING.md lacks important information:

  • No guidance for first-time contributors
  • No development setup instructions
  • No commit message conventions
  • No review process timeline
  • Missing testing guidelines

✨ Changes

10 New Sections:

  • Table of Contents
  • Getting Started
  • First Time Contributors (with resources for newcomers)
  • How to Contribute (docs/code/testing/community)
  • Development Setup (complete instructions)
  • Commit Message Guidelines (Conventional Commits)
  • Review Process & Timeline (clear expectations)
  • Testing guidelines
  • Recognition & Attribution
  • Community resources

5 Enhanced Sections:

  • Bug Reports (added templates and examples)
  • Feature Requests (added evaluation criteria)
  • Pull Requests (expanded to 5-step process)
  • Code of Conduct (added specific examples)
  • Support Requests (added alternative channels)

📊 Impact

Before: 300 words, 5 sections
After: 3,100 words, 15 sections
Improvement: +933% content, +200% sections

📚 References

Follows best practices from Atom, Node.js, and Kubernetes contributing guides.

✅ Checklist

  • All original content preserved and enhanced
  • Industry standards followed
  • Examples tested and working
  • Links verified
  • No breaking changes

This significantly improves the contributor experience for Base Node operators.

…ines

This PR transforms the CONTRIBUTING.md from a basic 300-word document into
a comprehensive 3,100-word contribution guide following industry best practices.

Major additions:
- 🌟 First Time Contributors section with curated resources
- 🔧 Complete Development Setup instructions
- 📝 Commit Message Guidelines (Conventional Commits)
- 🔍 Review Process & Timeline expectations
- 🧪 Testing guidelines and examples
- 🏆 Recognition & Attribution model
- 🌐 Community resources and support channels
- 📄 License information and DCO

The improvements follow best practices from major open-source projects
(Atom, Node.js, Kubernetes) making it significantly easier for both new
and experienced contributors to understand the contribution process.
@cb-heimdall
Copy link
Collaborator

cb-heimdall commented Oct 28, 2025

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

@haardikk21 haardikk21 closed this Oct 31, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants