Update README.md

Author: guibranco

README.md

@@ -1,45 +1,63 @@
-# .github Repository
+# 🏛️ Organization-wide GitHub configuration
 
-This repository serves as the **community health repository** for the organization. It contains default files and templates that will apply across all repositories within the organization unless explicitly overridden. These files ensure consistency and maintain best practices across projects.
+This repository acts as the **community health repository** for the organization. It provides **default templates and guidelines** that apply automatically across all repositories, unless specifically overridden. Its purpose is to enforce best practices, promote consistency, and streamline contribution workflows.
 
-## Repository Contents
+---
+
+## 📦 Repository contents
+
+### 1. Issue and pull request templates 📝
+Standardized templates to guide contributors and maintain clean, useful conversations.
+
+- `.github/ISSUE_TEMPLATE/bug_report.md` 🐛 – For reporting bugs
+- `.github/ISSUE_TEMPLATE/feature_request.md` ✨ – For feature suggestions
+- `.github/PULL_REQUEST_TEMPLATE.md` 🔄 – For submitting pull requests
+
+### 2. Code of conduct 🤝  
+Promotes a respectful and inclusive community across all organization projects.
 
-### 1. **Issue and Pull Request Templates** 📝
-- **Purpose**: Streamline the contribution process by providing pre-defined templates for issues and pull requests.
-- **Files**:
-  - `.github/ISSUE_TEMPLATE/bug_report.md` 🐛: Template for reporting bugs.
-  - `.github/ISSUE_TEMPLATE/feature_request.md` ✨: Template for requesting new features.
-  - `.github/PULL_REQUEST_TEMPLATE.md` 🔄: Template for submitting pull requests.
+- `CODE_OF_CONDUCT.md`
 
-### 2. **Code of Conduct** 🤝
-- **Purpose**: Establish community guidelines to foster a respectful and inclusive environment.
-- **File**: `CODE_OF_CONDUCT.md`
+### 3. Contributing guidelines 📜  
+Outlines how to contribute to organization repositories, including branch strategy and review processes.
 
-### 3. **Contributing Guidelines** 📜
-- **Purpose**: Provide clear instructions for contributing to projects within the organization.
-- **File**: `CONTRIBUTING.md`
+- `CONTRIBUTING.md`
 
-### 4. **Security Policy** 🔒
-- **Purpose**: Define the process for reporting security vulnerabilities.
-- **File**: `SECURITY.md`
+### 4. Security policy 🔒  
+Describes how to report vulnerabilities securely and responsibly.
 
-## How It Works
-The files in this repository are automatically applied to all repositories in the organization. However, any individual repository can override these defaults by providing its own corresponding file(s).
+- `SECURITY.md`
 
-## Customization ✏️
-If your repository requires specific configurations or templates, you can:
-- Add the required file(s) directly to your repository.
-- Update the content to meet the specific needs of that project.
+---
+
+## ⚙️ How it works
+
+GitHub automatically applies the files from this `.github` repository to **all organization repositories** unless they include their own versions of the same files. This ensures every project starts with solid community and contribution standards.
+
+---
+
+## ✏️ Customization
+
+To override or extend the defaults for a specific repository:
+- Add your custom file (e.g. `CONTRIBUTING.md`, `ISSUE_TEMPLATE`) to that repository.
+- GitHub will use the local version instead of the one in `.github`.
+
+---
+
+## 🤗 Contributing
+
+We welcome improvements to these shared templates and guidelines!
 
-## Contribution 🤗
-Contributions to improve this repository are welcome! To contribute:
 1. Fork this repository.
-2. Make your changes in a new branch.
-3. Submit a pull request with a detailed description of the changes.
+2. Create a new branch for your changes.
+3. Submit a pull request with a clear description of what you’re improving and why.
+
+---
+
+## 📄 License
 
-## License 📄
-This repository and its contents are licensed under the [MIT License](LICENSE).
+This repository is licensed under the [MIT License](LICENSE).
 
 ---
 
-**Note**: For more information about GitHub community health files, visit the [official documentation](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file).
+> ℹ️ For more details about GitHub community health files, check out the [official GitHub documentation](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file).