From 9333725cb55b8c0cd9c940507532480c7854dea3 Mon Sep 17 00:00:00 2001 From: Yeongseon Choe Date: Tue, 27 Oct 2026 02:14:33 +0900 Subject: [PATCH] docs(readme): make first-contribution opportunities easy to find Closes #854 Add a concise Contributing section to README.md that: - Links to CONTRIBUTING.md for setup and workflows - Distinguishes 'good first issue' (for first-time contributors) from 'help wanted' (general community contributions) - Encourages prospective contributors to comment before starting - Welcomes bug reports and documentation improvements - Does not duplicate CONTRIBUTING.md or rewrite existing guides The section appears before Disclaimer and License, keeping CONTRIBUTING.md as the single source of truth for setup and process details. Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index bbfb856..59927d1 100644 --- a/README.md +++ b/README.md @@ -471,6 +471,26 @@ These files provide comprehensive package and API information optimized for LLM Use these files to get better context when working with this package in AI-assisted coding environments. +## Contributing + +We welcome contributions! This package is maintained as open source and improves through community involvement. + +**Getting started:** See the [Contributing Guide](CONTRIBUTING.md) for setup, testing, and pull request workflows. + +**Find an issue to work on:** + +- **[Good first issue](https://github.com/yeongseon/azure-functions-openapi-python/labels/good%20first%20issue)** — scoped for first-time contributors. These are bounded, independently verifiable, and include clear acceptance criteria. +- **[Help wanted](https://github.com/yeongseon/azure-functions-openapi-python/labels/help%20wanted)** — community contributions welcomed. These may require more familiarity with the codebase or Azure Functions. + +**Before you start:** Please comment on the issue to discuss it first. This helps clarify ownership, expectations, and scope before you begin work. + +**Contributions we welcome:** +- Bug fixes and feature implementations (when labeled with `good first issue` or `help wanted`) +- Documentation improvements and examples (even when no label exists) +- Test coverage and diagnostic improvements + +**No pull request without an issue:** Open or reference an issue first — this keeps work coordinated and prevents duplicate effort. + ## Disclaimer This project is an independent community project and is not affiliated with,