Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions .github/DISCUSSIONS.md
Original file line number Diff line number Diff line change
@@ -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)
5 changes: 5 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

---

<a href="https://www.buymeacoffee.com/pbialon" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
5 changes: 5 additions & 0 deletions README.pl.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

---

<a href="https://www.buymeacoffee.com/pbialon" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
Loading