Merge branch 'main' of https://github.com/pinnotes/pinnotes.github.io

Author: simplearyan

CONTRIBUTING.md

@@ -0,0 +1,158 @@
+# CONTRIBUTING.md
+
+## 🚀 Welcome to the Hugo Project!
+
+Thank you for your interest in contributing to Hugo! We value every kind of contribution, from code to documentation, bug reports, and community support. Let’s build something amazing together! 🌟
+
+---
+
+## 📋 Table of Contents
+
+- [CONTRIBUTING.md](#contributingmd)
+  - [🚀 Welcome to the Hugo Project!](#-welcome-to-the-hugo-project)
+  - [📋 Table of Contents](#-table-of-contents)
+  - [🧑‍💻 How to Contribute](#-how-to-contribute)
+  - [🤝 Code of Conduct](#-code-of-conduct)
+  - [🌈 Ways to Contribute](#-ways-to-contribute)
+  - [🛠️ Development Setup](#️-development-setup)
+  - [🐞 Reporting Issues](#-reporting-issues)
+  - [📦 Submitting Pull Requests](#-submitting-pull-requests)
+  - [📝 Commit Message Guidelines](#-commit-message-guidelines)
+  - [🎉 Recognition](#-recognition)
+  - [📬 Contact](#-contact)
+  - [⚠️ Rules \& Reminders](#️-rules--reminders)
+
+---
+
+## 🧑‍💻 How to Contribute
+
+1. **Fork** the repository and create your branch from `master`.
+2. **Make your changes**—whether it’s code, documentation, or bug fixes.
+3. **Test** your changes locally.
+4. **Submit a Pull Request** for review.
+
+_If you’re new to open source, don’t worry! The Hugo team and community are here to help you get started._[^1][^2][^3]
+
+---
+
+## 🤝 Code of Conduct
+
+We are committed to fostering a welcoming and inclusive environment. Please be respectful and considerate to others. For more details, see our [Code of Conduct](CODE_OF_CONDUCT.md). 🫶
+
+---
+
+## 🌈 Ways to Contribute
+
+- 💬 **Answer questions** on the [forum](https://discourse.gohugo.io/)
+- 📝 **Improve documentation**
+- 🐛 **Report and squash bugs**
+- 🎨 **Create or improve themes**
+- 🚀 **Suggest or implement new features**
+- 🧹 **Help manage issues and discussions**
+
+---
+
+## 🛠️ Development Setup
+
+Before you start, ensure you have:
+
+- [ ] **Git**
+- [ ] **Go** (version 1.23.0 or later)
+- [ ] **C compiler** (GCC or Clang)
+- [ ] Updated your `PATH` as per [Go documentation](https://golang.org/doc/install)
+
+For detailed setup instructions, see the [Development Guide](https://gohugo.io/contribute/development/).[^2]
+
+---
+
+## 🐞 Reporting Issues
+
+- Search existing issues before opening a new one.
+- For bugs, include:
+    - Hugo version (`hugo version`)
+    - Operating system
+    - Steps to reproduce
+- Use the appropriate repository for documentation or theme issues.
+
+_If unsure, ask in the [forum](https://discourse.gohugo.io/) first!_ [^1][^3]
+
+---
+
+## 📦 Submitting Pull Requests
+
+- Fork and make changes in a feature branch.
+- Reference an open issue (with `bug` or `enhancement` label) for non-trivial changes.
+- Add or update tests as needed.
+- Run `go fmt` and ensure `mage check` passes.
+- Squash your commits into one (`git rebase -i`).
+- Sign the CLA if prompted.
+- Add documentation for new features or changes.
+- Submit your PR and describe your changes clearly.
+
+---
+
+## 📝 Commit Message Guidelines
+
+- Use clear, concise messages.
+- Prefix with type: `fix:`, `feat:`, `docs:`, `refactor:`, etc.
+- Example: `fix: resolve panic on empty config`
+
+---
+
+## 🎉 Recognition
+
+All contributors are recognized and appreciated! Check out our [contributors list](humans.txt) and join our awesome community! 🏆
+
+---
+
+## 📬 Contact
+
+For questions or help, reach out via:
+
+- [Hugo Discussion Forum](https://discourse.gohugo.io/)
+- [GitHub Issues](https://github.com/gohugoio/hugo/issues)
+
+---
+
+> _Thank you for helping Hugo grow! Every contribution makes a difference. Happy coding!_ 💖
+
+---
+
+## ⚠️ Rules \& Reminders
+
+- Be kind and constructive 🤗
+- No spam or off-topic content 🚫
+- Keep discussions public and transparent 💬
+- Respect review decisions and feedback 🙏
+- Have fun and learn! 🎓
+
+---
+
+_Ready to contribute? Fork, code, and PR away!_ 🚀
+
+---
+
+This guideline is based on Hugo’s official contribution process and best practices for open source projects[^1][^2][^4][^5].
+
+<div style="text-align: center">⁂</div>
+
+[^1]: https://github.com/gohugoio/hugo/blob/master/CONTRIBUTING.md
+
+[^2]: https://gohugo.io/contribute/development/
+
+[^3]: https://gohugo.io/contribute/
+
+[^4]: https://contributing.md/how-to-build-contributing-md/
+
+[^5]: https://github.com/nayafia/contributing-template
+
+[^6]: https://discourse.gohugo.io/t/best-way-to-contribute/36839
+
+[^7]: https://docs.github.com/articles/setting-guidelines-for-repository-contributors
+
+[^8]: https://gohugobrasil.netlify.app/contribute/
+
+[^9]: https://docs.hugoblox.com/reference/contribute/
+
+[^10]: https://github.com/usnistgov/hugo-uswds/blob/main/CONTRIBUTING.md
+