diff --git a/.github/DISCUSSIONS.md b/.github/DISCUSSIONS.md
new file mode 100644
index 0000000..c9204ef
--- /dev/null
+++ b/.github/DISCUSSIONS.md
@@ -0,0 +1,41 @@
+# GitHub Discussions setup
+
+This document captures the category layout and seed threads created for
+pit-38 Discussions. Future maintainers can use it to reconstitute the
+space if needed, or to understand the rationale behind the category split.
+
+## Categories
+
+| Category | Format | Purpose |
+|----------|--------|---------|
+| **Announcements** 📣 | Announcement (maintainer-only) | Release notes, tax-law updates, breaking changes |
+| **Q&A** 🙏 | Question + marked answer | Tax-rule interpretation questions where there's a definite answer |
+| **Broker support** 🏦 | Open-ended | Broker requests, sanitized CSV samples, discussion of quirks |
+
+Other default categories (General, Ideas, Polls, Show and tell) are
+hidden — we want a focused, low-cognitive-load surface. If traffic grows,
+re-enabling them is trivial in Settings → Discussions.
+
+## Seed threads
+
+| # | Category | Title |
+|---|----------|-------|
+| [#72](https://github.com/pbialon/pit-38/discussions/72) | Q&A | How do I handle W-8BEN dividends in PIT-38? |
+| [#73](https://github.com/pbialon/pit-38/discussions/73) | Broker support | Which broker should we support next? |
+| [#74](https://github.com/pbialon/pit-38/discussions/74) | Announcements | Welcome to pit-38 Discussions |
+
+## Posting conventions
+
+- **Language**: Polish and English both welcome. Maintainers respond in
+ the language of the thread. Use `[PL]` prefix in title if Polish-only.
+- **Announcements**: maintainer-only by category configuration.
+- **Broker support**: encourage sanitized CSV snippets (5–10 rows max,
+ PII removed) rather than full exports. See issue #33 for an example
+ of how real exports informed the BOM/locale fixes.
+- **Q&A**: maintainers can mark the accepted answer to boost future
+ searchability — we're using Discussions partly as a knowledge base.
+
+## Links
+
+- [Discussions landing](https://github.com/pbialon/pit-38/discussions)
+- [Closing issue](https://github.com/pbialon/pit-38/issues/48)
diff --git a/README.md b/README.md
index a980f71..416fd3d 100644
--- a/README.md
+++ b/README.md
@@ -97,6 +97,11 @@ pytest tests/
This tool is provided for **informational purposes only** and does not constitute tax advice. Always verify your calculations with a qualified tax advisor before filing your PIT-38 declaration.
+## Community
+
+- **[GitHub Discussions](https://github.com/pbialon/pit-38/discussions)** — tax-rule Q&A, broker requests, feedback. English and Polish both welcome.
+- **[Issue tracker](https://github.com/pbialon/pit-38/issues)** — bug reports and feature requests.
+
---
diff --git a/README.pl.md b/README.pl.md
index 99891ca..e7e3169 100644
--- a/README.pl.md
+++ b/README.pl.md
@@ -97,6 +97,11 @@ pytest tests/
To narzędzie służy wyłącznie **celom informacyjnym** i nie stanowi porady podatkowej. Przed złożeniem deklaracji PIT-38 zweryfikuj obliczenia z doradcą podatkowym.
+## Społeczność
+
+- **[GitHub Discussions](https://github.com/pbialon/pit-38/discussions)** — pytania o zasady podatkowe, prośby o wsparcie nowych brokerów, feedback. Po polsku i angielsku.
+- **[Issue tracker](https://github.com/pbialon/pit-38/issues)** — zgłoszenia błędów i propozycje funkcji.
+
---