Skip to content

Conversation

@AnupmaMishra12
Copy link

This PR improves the readability and structure of three key community documents:

  • Added a welcoming intro line to GOVERNANCE.md
  • Converted plain URLs to markdown links
  • Polished grammar and tone for inclusivity
  • Ensured consistent heading levels across files

These changes aim to support onboarding clarity and maintain open-source etiquette.
Contributed by @AnupmaMishra12

@netlify
Copy link

netlify bot commented Nov 9, 2025

Deploy Preview for carvel ready!

Name Link
🔨 Latest commit ff5e1f5
🔍 Latest deploy log https://app.netlify.com/projects/carvel/deploys/69246e5d593f8b00080537cd
😎 Deploy Preview https://deploy-preview-816--carvel.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@carvel-bot carvel-bot added this to Carvel Nov 9, 2025
@AnupmaMishra12
Copy link
Author

Hi! This PR improves clarity and formatting in key community documents.
Please let me know if any changes are needed.
Also, kindly approve the pending workflows so checks can complete.
Thanks! — @AnupmaMishra12

Copy link
Author

@AnupmaMishra12 AnupmaMishra12 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for putting this together! The governance guide is quite comprehensive.
Just a few suggestions to improve clarity and consistency:

  • Remove duplicate headings (# Carvel Governance appears twice).
  • Fix the incomplete sentence under “Proposal Process”.
  • Use consistent heading levels across sections (e.g., Supermajority, Decision Making).
  • Consider replacing relative links with full GitHub URLs for better accessibility.
  • Improve formatting of bullet points and spacing for readability.
  • Clarify voting logic with a simple example.
  • Optional: Add a Table of Contents and last updated date for easier navigation.

Happy to help refine this further if needed!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant