From c859566ff09da3ea2edb7a46d91e308e13eeb36b Mon Sep 17 00:00:00 2001 From: Myasnikov Daniil Date: Tue, 9 Jun 2026 11:40:44 +0500 Subject: [PATCH] docs: clarify where contributions land and fix dead design-proposals link Add a "Where do I file?" routing table and an issue-template chooser that points bugs and features back to cozystack/cozystack and reserves this repo for design proposals and governance. Fix the README link to the design-proposal guidelines, which pointed at docs/design-proposals/ in the cozystack repo -- a path that no longer exists. It now points at ./design-proposals/README.md in this repo. Co-Authored-By: Claude Opus 4.8 (1M context) Signed-off-by: Myasnikov Daniil --- .github/ISSUE_TEMPLATE/config.yml | 14 ++++++++++++++ README.md | 15 ++++++++++++--- 2 files changed, 26 insertions(+), 3 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/config.yml diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..fb8dc7f --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,14 @@ +blank_issues_enabled: true +contact_links: + - name: 🐛 Bug in Cozystack + url: https://github.com/cozystack/cozystack/issues/new/choose + about: Bugs live in the main cozystack repo, not here. + - name: ✨ Feature request + url: https://github.com/cozystack/cozystack/issues/new/choose + about: Concrete, scoped features go in the main cozystack repo. + - name: 📐 Design proposal / RFC + url: https://github.com/cozystack/community/tree/main/design-proposals + about: Architectural or cross-cutting changes — open a design-proposal PR (markdown) in this repo. Open a blank issue here only for governance, process, or community topics. + - name: 💬 Question or early idea + url: https://github.com/cozystack/cozystack/discussions + about: Usage questions and half-formed ideas — use the cozystack Discussions tab or Telegram (https://t.me/cozystack). diff --git a/README.md b/README.md index 5518514..15bc17a 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,17 @@ This repo contains (or will contain soon): We aim to make contributing to Cozystack open, transparent, and rewarding. +## Where do I file? + +Cozystack work is split across two repositories. This repo is for **how we decide and what we should build**; the [cozystack/cozystack](https://github.com/cozystack/cozystack) repo is for **the product itself**. + +| You have… | Where it goes | +|---|---| +| A **bug** or a **concrete, scoped feature** | [cozystack/cozystack issues](https://github.com/cozystack/cozystack/issues/new/choose) | +| A **usage question** or an early idea | [cozystack/cozystack Discussions](https://github.com/cozystack/cozystack/discussions) | +| A **cross-cutting / architectural change** — affects multiple components or APIs, or needs a decision before code | A [design proposal](./design-proposals/README.md) (a PR) **here** | +| **Governance, process, or community** matters | An issue **here** | + ## Community Resources - [Cozystack website](https://cozystack.io/) @@ -39,9 +50,7 @@ Whether you're reporting an issue, proposing a feature, joining a working group, to ensure a respectful and inclusive environment for all community members. - If you're using Cozystack, feel free to [add yourself to the ADOPTERS.md](https://github.com/cozystack/cozystack/blob/main/ADOPTERS.md) — we'd love to hear from you! -- Thinking about a big feature or architectural change? - Start with our [design proposal guidelines](https://github.com/cozystack/cozystack/blob/main/docs/design-proposals/README.md) - to ensure a structured and collaborative discussion. +- Thinking about a big feature or architectural change? Start with our [design proposal guidelines](./design-proposals/README.md) to ensure a structured and collaborative discussion. ## Inspiration