diff --git a/.github/DISCUSSION_TEMPLATE/ideas_cs.yml b/.github/DISCUSSION_TEMPLATE/ideas_cs.yml new file mode 100644 index 0000000..0eaece8 --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/ideas_cs.yml @@ -0,0 +1,24 @@ +--- +title: "Nápad: " +labels: ["ideas"] +--- + +## 💡 Váš nápad + +Popište svůj nápad jasně a stručně. + +## 🎯 Jaký problém to řeší? + +Vysvětlete, jaký problém nebo potřebu tento nápad adresuje. + +## 🌐 Vztah k otevřeným formátům + +Jak tento nápad souvisí s otevřenými formáty pro výměnu dat? + +## 📊 Případy použití + +Uveďte konkrétní příklady, jak by váš nápad mohl být použit. + +## 💬 Diskuze + +Jaké otázky nebo obavy máte ohledně tohoto nápadu? diff --git a/.github/DISCUSSION_TEMPLATE/ideas_en.yml b/.github/DISCUSSION_TEMPLATE/ideas_en.yml new file mode 100644 index 0000000..0bb61ac --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/ideas_en.yml @@ -0,0 +1,24 @@ +--- +title: "Idea: " +labels: ["ideas"] +--- + +## 💡 Your Idea + +Describe your idea clearly and concisely. + +## 🎯 What Problem Does This Solve? + +Explain what problem or need this idea addresses. + +## 🌐 Relation to Open Formats + +How does this idea relate to open formats for data exchange? + +## 📊 Use Cases + +List specific examples of how your idea could be used. + +## 💬 Discussion + +What questions or concerns do you have about this idea? diff --git a/.github/DISCUSSION_TEMPLATE/q-a_cs.yml b/.github/DISCUSSION_TEMPLATE/q-a_cs.yml new file mode 100644 index 0000000..912725f --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/q-a_cs.yml @@ -0,0 +1,20 @@ +--- +title: "Otázka: " +labels: ["q&a"] +--- + +## ❓ Vaše otázka + +Položte svou otázku jasně a stručně. + +## 🔍 Co jste již zkoušeli? + +Popište, co jste již vyzkoušeli nebo kde jste hledali odpověď. + +## 📋 Kontext + +Poskytněte jakýkoliv další kontext, který by mohl pomoci odpovědět na vaši otázku. + +- **Formát dat**: (např. JSON, CSV, XML) +- **Velikost dat**: (např. malá, střední, velká) +- **Prostředí**: (např. Node.js, Python, prohlížeč) diff --git a/.github/DISCUSSION_TEMPLATE/q-a_en.yml b/.github/DISCUSSION_TEMPLATE/q-a_en.yml new file mode 100644 index 0000000..31c87ed --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/q-a_en.yml @@ -0,0 +1,20 @@ +--- +title: "Question: " +labels: ["q&a"] +--- + +## ❓ Your Question + +Ask your question clearly and concisely. + +## 🔍 What Have You Already Tried? + +Describe what you have already tried or where you looked for an answer. + +## 📋 Context + +Provide any additional context that could help answer your question. + +- **Data Format**: (e.g., JSON, CSV, XML) +- **Data Size**: (e.g., small, medium, large) +- **Environment**: (e.g., Node.js, Python, browser) diff --git a/.github/DISCUSSION_TEMPLATE/show-and-tell_cs.yml b/.github/DISCUSSION_TEMPLATE/show-and-tell_cs.yml new file mode 100644 index 0000000..1f7bd80 --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/show-and-tell_cs.yml @@ -0,0 +1,30 @@ +--- +title: "Ukázka: " +labels: ["show-and-tell"] +--- + +## 🎉 Co jste vytvořili? + +Popište, co jste vytvořili a co to dělá. + +## 🔗 Odkazy + +- GitHub repozitář: +- Demo / ukázka: +- Dokumentace: + +## 🛠️ Technologie + +Jaké otevřené formáty a technologie jste použili? + +- Formáty dat: +- Knihovny/nástroje: +- Jazyk: + +## 📸 Snímky obrazovky nebo ukázky + +Přidejte snímky obrazovky, GIFy nebo ukázky kódu. + +## 💬 Zpětná vazba + +Jakou zpětnou vazbu hledáte od komunity? diff --git a/.github/DISCUSSION_TEMPLATE/show-and-tell_en.yml b/.github/DISCUSSION_TEMPLATE/show-and-tell_en.yml new file mode 100644 index 0000000..9c692f0 --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/show-and-tell_en.yml @@ -0,0 +1,30 @@ +--- +title: "Show: " +labels: ["show-and-tell"] +--- + +## 🎉 What Did You Create? + +Describe what you created and what it does. + +## 🔗 Links + +- GitHub repository: +- Demo / showcase: +- Documentation: + +## 🛠️ Technologies + +What open formats and technologies did you use? + +- Data formats: +- Libraries/tools: +- Language: + +## 📸 Screenshots or Examples + +Add screenshots, GIFs, or code examples. + +## 💬 Feedback + +What feedback are you looking for from the community? diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 0000000..0ffc6e5 --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1,2 @@ +# Do not modify this file, it is generated by GitHub +# This file is used to display sponsor button in the repository diff --git a/.github/ISSUE_TEMPLATE/bug_report_cs.md b/.github/ISSUE_TEMPLATE/bug_report_cs.md new file mode 100644 index 0000000..a8e380b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report_cs.md @@ -0,0 +1,53 @@ +--- +name: 🐛 Nahlášení chyby +about: Vytvořte hlášení o chybě, abyste nám pomohli zlepšit projekt +title: '[BUG] ' +labels: ['bug', 'needs-triage'] +assignees: '' +--- + +## 📝 Popis chyby + +Jasný a stručný popis toho, co je chyba. + +## 🔄 Kroky k reprodukci + +Kroky k reprodukci chování: + +1. Přejděte na '...' +2. Klikněte na '...' +3. Sjeďte dolů na '...' +4. Zobrazí se chyba + +## ✅ Očekávané chování + +Jasný a stručný popis toho, co jste očekávali, že se stane. + +## ❌ Skutečné chování + +Jasný a stručný popis toho, co se skutečně stalo. + +## 📸 Snímky obrazovky + +Pokud je to relevantní, přidejte snímky obrazovky, které pomohou vysvětlit problém. + +## 🖥️ Prostředí + +- **OS**: [např. Windows 11, macOS 14, Ubuntu 22.04] +- **Prohlížeč**: [např. Chrome 120, Firefox 121] +- **Verze projektu**: [např. 1.2.3] +- **Formát dat**: [např. JSON, CSV, XML] + +## 📋 Další kontext + +Přidejte jakýkoliv další kontext o problému zde. Například: + +- Pracujete s velkými soubory? +- Používáte specifický formát dat? +- Vyskytuje se problém konzistentně nebo občas? + +## ✔️ Kontrolní seznam + +- [ ] Zkontroloval(a) jsem existující issues +- [ ] Problém lze reprodukovat +- [ ] Přidal(a) jsem všechny relevantní informace diff --git a/.github/ISSUE_TEMPLATE/bug_report_en.md b/.github/ISSUE_TEMPLATE/bug_report_en.md new file mode 100644 index 0000000..da14c14 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report_en.md @@ -0,0 +1,53 @@ +--- +name: 🐛 Bug Report +about: Create a bug report to help us improve the project +title: '[BUG] ' +labels: ['bug', 'needs-triage'] +assignees: '' +--- + +## 📝 Bug Description + +A clear and concise description of what the bug is. + +## 🔄 Steps to Reproduce + +Steps to reproduce the behavior: + +1. Go to '...' +2. Click on '...' +3. Scroll down to '...' +4. See error + +## ✅ Expected Behavior + +A clear and concise description of what you expected to happen. + +## ❌ Actual Behavior + +A clear and concise description of what actually happened. + +## 📸 Screenshots + +If applicable, add screenshots to help explain the problem. + +## 🖥️ Environment + +- **OS**: [e.g., Windows 11, macOS 14, Ubuntu 22.04] +- **Browser**: [e.g., Chrome 120, Firefox 121] +- **Project Version**: [e.g., 1.2.3] +- **Data Format**: [e.g., JSON, CSV, XML] + +## 📋 Additional Context + +Add any other context about the problem here. For example: + +- Are you working with large files? +- Are you using a specific data format? +- Does the problem occur consistently or intermittently? + +## ✔️ Checklist + +- [ ] I have checked existing issues +- [ ] The problem can be reproduced +- [ ] I have added all relevant information diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..e530bfc --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: 💬 Diskuze a otázky / Discussions and Questions + url: https://github.com/tabulky/.github/discussions + about: Pokládejte otázky, sdílejte nápady a diskutujte s komunitou / Ask questions, share ideas and discuss with the community + - name: 📚 Dokumentace / Documentation + url: https://github.com/tabulky/.github + about: Přečtěte si dokumentaci projektu / Read the project documentation diff --git a/.github/ISSUE_TEMPLATE/documentation_cs.md b/.github/ISSUE_TEMPLATE/documentation_cs.md new file mode 100644 index 0000000..a92f29a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/documentation_cs.md @@ -0,0 +1,39 @@ +--- +name: 📖 Vylepšení dokumentace +about: Navrhněte vylepšení nebo opravu dokumentace +title: '[DOCS] ' +labels: ['documentation', 'needs-triage'] +assignees: '' +--- + +## 📄 Která část dokumentace potřebuje vylepšení? + +Uveďte konkrétní stránku, sekci nebo soubor dokumentace. + +## ❓ Jaký je problém s aktuální dokumentací? + +- [ ] Chybějící informace +- [ ] Nepřesné informace +- [ ] Zastaralé informace +- [ ] Nejasné vysvětlení +- [ ] Překlepy nebo gramatické chyby +- [ ] Jiné: _________ + +## ✏️ Navrhované vylepšení + +Popište, jak by měla být dokumentace vylepšena. + +## 📚 Dodatečné zdroje + +Pokud existují externí zdroje nebo příklady, které by mohly pomoci, uveďte je zde. + +## 🌍 Jazyk + +- [ ] Čeština +- [ ] Angličtina +- [ ] Jiný: _________ + +## ✔️ Kontrolní seznam + +- [ ] Zkontroloval(a) jsem, že tento problém ještě není nahlášen +- [ ] Jasně jsem popsal(a) problém a řešení diff --git a/.github/ISSUE_TEMPLATE/documentation_en.md b/.github/ISSUE_TEMPLATE/documentation_en.md new file mode 100644 index 0000000..82f91d8 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/documentation_en.md @@ -0,0 +1,39 @@ +--- +name: 📖 Documentation Improvement +about: Propose an improvement or fix for documentation +title: '[DOCS] ' +labels: ['documentation', 'needs-triage'] +assignees: '' +--- + +## 📄 Which part of the documentation needs improvement? + +Specify the page, section, or documentation file. + +## ❓ What is the problem with the current documentation? + +- [ ] Missing information +- [ ] Inaccurate information +- [ ] Outdated information +- [ ] Unclear explanation +- [ ] Typos or grammatical errors +- [ ] Other: _________ + +## ✏️ Proposed Improvement + +Describe how the documentation should be improved. + +## 📚 Additional Resources + +If there are external resources or examples that could help, list them here. + +## 🌍 Language + +- [ ] Czech +- [ ] English +- [ ] Other: _________ + +## ✔️ Checklist + +- [ ] I have checked that this issue is not already reported +- [ ] I have clearly described the problem and solution diff --git a/.github/ISSUE_TEMPLATE/feature_request_cs.md b/.github/ISSUE_TEMPLATE/feature_request_cs.md new file mode 100644 index 0000000..430acd8 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request_cs.md @@ -0,0 +1,48 @@ +--- +name: 🚀 Návrh nové funkce +about: Navrhněte novou funkci nebo vylepšení pro projekt +title: '[FEATURE] ' +labels: ['enhancement', 'needs-triage'] +assignees: '' +--- + +## 🎯 Cíl + +Jaký problém tato funkce řeší? Jasně popište, proč je tato funkce potřebná. + +## 💡 Návrh řešení + +Jasný a stručný popis toho, co chcete, aby se stalo. Popište navrhovanou funkci. + +## 🔄 Alternativy + +Jasný a stručný popis jakýchkoliv alternativních řešení nebo funkcí, které jste zvažovali. + +## 📊 Případy použití + +Popište konkrétní případy použití této funkce: + +1. Jako [typ uživatele] +2. Chci [cíl/potřeba] +3. Aby [výhoda/hodnota] + +## 🌐 Vztah k otevřeným formátům + +Jak tato funkce podporuje práci s otevřenými formáty pro výměnu dat? + +- [ ] Podporuje nový otevřený formát +- [ ] Zlepšuje práci s existujícím formátem +- [ ] Zvyšuje interoperabilitu +- [ ] Zlepšuje standardizaci +- [ ] Jiné: _________ + +## 📋 Dodatečný kontext + +Přidejte jakýkoliv další kontext, snímky obrazovky nebo mockupy o návrhu funkce. + +## ✔️ Kontrolní seznam + +- [ ] Zkontroloval(a) jsem existující návrhy funkcí +- [ ] Tato funkce je relevantní pro cíle projektu +- [ ] Popsal(a) jsem jasné případy použití +- [ ] Zvážil(a) jsem alternativní řešení diff --git a/.github/ISSUE_TEMPLATE/feature_request_en.md b/.github/ISSUE_TEMPLATE/feature_request_en.md new file mode 100644 index 0000000..56418aa --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request_en.md @@ -0,0 +1,48 @@ +--- +name: 🚀 Feature Request +about: Propose a new feature or enhancement for the project +title: '[FEATURE] ' +labels: ['enhancement', 'needs-triage'] +assignees: '' +--- + +## 🎯 Goal + +What problem does this feature solve? Clearly describe why this feature is needed. + +## 💡 Proposed Solution + +A clear and concise description of what you want to happen. Describe the proposed feature. + +## 🔄 Alternatives + +A clear and concise description of any alternative solutions or features you've considered. + +## 📊 Use Cases + +Describe specific use cases for this feature: + +1. As a [type of user] +2. I want [goal/need] +3. So that [benefit/value] + +## 🌐 Relation to Open Formats + +How does this feature support working with open formats for data exchange? + +- [ ] Supports a new open format +- [ ] Improves work with existing format +- [ ] Increases interoperability +- [ ] Improves standardization +- [ ] Other: _________ + +## 📋 Additional Context + +Add any other context, screenshots, or mockups about the feature proposal. + +## ✔️ Checklist + +- [ ] I have checked existing feature proposals +- [ ] This feature is relevant to project goals +- [ ] I have described clear use cases +- [ ] I have considered alternative solutions diff --git a/.github/PULL_REQUEST_TEMPLATE/pull_request_template_cs.md b/.github/PULL_REQUEST_TEMPLATE/pull_request_template_cs.md new file mode 100644 index 0000000..6e6a7a6 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE/pull_request_template_cs.md @@ -0,0 +1,63 @@ +## 📝 Popis změn + +Stručně popište, co tento pull request mění a proč. + +## 🔗 Související issues + +Fixes #(číslo issue) +Related to #(číslo issue) + +## 🎯 Typ změny + +- [ ] 🐛 Oprava chyby (non-breaking change, která opravuje issue) +- [ ] ✨ Nová funkce (non-breaking change, která přidává funkcionalitu) +- [ ] 💥 Breaking change (oprava nebo funkce, která by způsobila nefungování existující funkcionality) +- [ ] 📖 Aktualizace dokumentace +- [ ] 🎨 Změny stylu (formátování, chybějící středníky, atd.) +- [ ] ♻️ Refaktoring kódu +- [ ] ⚡ Vylepšení výkonu +- [ ] ✅ Přidání nebo aktualizace testů +- [ ] 🔧 Změny konfigurace nebo build scriptu + +## 🧪 Jak bylo testováno? + +Popište testy, které jste provedli k ověření vašich změn: + +- [ ] Test A +- [ ] Test B + +**Testovací konfigurace**: +- OS: +- Verze: + +## 📊 Formáty dat + +Pokud vaše změny souvisejí s otevřenými formáty dat, uveďte: + +- [ ] JSON +- [ ] CSV +- [ ] XML +- [ ] YAML +- [ ] Jiné: _________ + +Popis práce s formátem: + +## ✔️ Kontrolní seznam + +- [ ] Můj kód dodržuje style guidelines projektu +- [ ] Provedl(a) jsem self-review vlastního kódu +- [ ] Okomentoval(a) jsem svůj kód, zejména v těžko pochopitelných oblastech +- [ ] Provedl(a) jsem odpovídající změny v dokumentaci +- [ ] Moje změny negenerují nová varování +- [ ] Přidal(a) jsem testy, které prokazují, že moje oprava je účinná nebo že moje funkce funguje +- [ ] Nové i existující unit testy procházejí lokálně s mými změnami +- [ ] Jakékoliv závislé změny byly sloučeny a publikovány v downstream modulech +- [ ] Zkontroloval(a) jsem, že používám otevřené formáty tam, kde je to možné + +## 📸 Snímky obrazovky (pokud je to relevantní) + +Přidejte snímky obrazovky, které ukazují změny v UI nebo výstupu. + +## 💬 Dodatečné poznámky + +Jakékoliv další informace, které by mohly být užitečné pro reviewery. diff --git a/.github/PULL_REQUEST_TEMPLATE/pull_request_template_en.md b/.github/PULL_REQUEST_TEMPLATE/pull_request_template_en.md new file mode 100644 index 0000000..8b7646e --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE/pull_request_template_en.md @@ -0,0 +1,63 @@ +## 📝 Description of Changes + +Briefly describe what this pull request changes and why. + +## 🔗 Related Issues + +Fixes #(issue number) +Related to #(issue number) + +## 🎯 Type of Change + +- [ ] 🐛 Bug fix (non-breaking change that fixes an issue) +- [ ] ✨ New feature (non-breaking change that adds functionality) +- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected) +- [ ] 📖 Documentation update +- [ ] 🎨 Style changes (formatting, missing semicolons, etc.) +- [ ] ♻️ Code refactoring +- [ ] ⚡ Performance improvement +- [ ] ✅ Adding or updating tests +- [ ] 🔧 Configuration or build script changes + +## 🧪 How Has This Been Tested? + +Describe the tests you ran to verify your changes: + +- [ ] Test A +- [ ] Test B + +**Test Configuration**: +- OS: +- Version: + +## 📊 Data Formats + +If your changes relate to open data formats, specify: + +- [ ] JSON +- [ ] CSV +- [ ] XML +- [ ] YAML +- [ ] Other: _________ + +Description of format work: + +## ✔️ Checklist + +- [ ] My code follows the style guidelines of this project +- [ ] I have performed a self-review of my own code +- [ ] I have commented my code, particularly in hard-to-understand areas +- [ ] I have made corresponding changes to the documentation +- [ ] My changes generate no new warnings +- [ ] I have added tests that prove my fix is effective or that my feature works +- [ ] New and existing unit tests pass locally with my changes +- [ ] Any dependent changes have been merged and published in downstream modules +- [ ] I have verified that I am using open formats where possible + +## 📸 Screenshots (if applicable) + +Add screenshots that show changes in UI or output. + +## 💬 Additional Notes + +Any other information that might be useful for reviewers. diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..2db3c66 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,42 @@ +# Kodex chování přispěvatelů + +## Náš závazek + +V zájmu podpory otevřeného a přívětivého prostředí se my, jako přispěvatelé a správci, zavazujeme, že účast v našem projektu a naší komunitě bude pro každého bez obtěžování, bez ohledu na věk, tělesnou konstituci, postižení, etnicitu, pohlaví, úroveň zkušeností, vzdělání, socioekonomický status, národnost, osobní vzhled, rasu, náboženství nebo sexuální identitu a orientaci. + +## Naše standardy + +Příklady chování, které přispívá k vytváření pozitivního prostředí: + +* Používání vstřícného a inkluzivního jazyka +* Respektování odlišných názorů a zkušeností +* Přijímání konstruktivní kritiky s grácií +* Zaměření na to, co je nejlepší pro komunitu +* Projevování empatie vůči ostatním členům komunity +* Podpora otevřených formátů a standardů pro výměnu dat + +Příklady nepřijatelného chování účastníků: + +* Používání sexualizovaného jazyka nebo obrazů a nevítaná sexuální pozornost +* Trolling, urážlivé/hanlivé komentáře a osobní nebo politické útoky +* Veřejné nebo soukromé obtěžování +* Zveřejňování soukromých informací ostatních, jako je fyzická nebo elektronická adresa, bez výslovného povolení +* Jiné chování, které by mohlo být důvodně považováno za nevhodné v profesionálním prostředí + +## Naše odpovědnosti + +Správci projektu jsou odpovědní za objasnění standardů přijatelného chování a očekává se, že podniknou vhodné a spravedlivé nápravné kroky v reakci na jakékoli případy nepřijatelného chování. + +Správci projektu mají právo a odpovědnost odstraňovat, upravovat nebo odmítat komentáře, commity, kód, wiki úpravy, issues a další příspěvky, které nejsou v souladu s tímto kodexem chování, nebo dočasně či trvale zakázat jakéhokoli přispěvatele za jiné chování, které považují za nevhodné, výhružné, urážlivé nebo škodlivé. + +## Rozsah působnosti + +Tento kodex chování platí jak v prostorách projektu, tak ve veřejných prostorech, když jednotlivec reprezentuje projekt nebo jeho komunitu. Příklady reprezentace projektu nebo komunity zahrnují používání oficiální e-mailové adresy projektu, zveřejňování prostřednictvím oficiálního účtu na sociálních médiích nebo působení jako jmenovaný zástupce na online nebo offline akci. + +## Vymáhání + +Případy zneužívajícího, obtěžujícího nebo jinak nepřijatelného chování mohou být nahlášeny kontaktováním projektového týmu. Všechny stížnosti budou přezkoumány a vyšetřeny a vyústí v odpověď, která je považována za nezbytnou a přiměřenou okolnostem. Projektový tým je povinen zachovávat mlčenlivost ohledně nahlašovatele incidentu. + +## Připsání + +Tento kodex chování je adaptován z [Contributor Covenant](https://www.contributor-covenant.org), verze 2.0, dostupné na https://www.contributor-covenant.org/version/2/0/code_of_conduct.html diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..428a7ac --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,93 @@ +# Přispívání do projektu + +Děkujeme za váš zájem přispět do naší komunity zaměřené na otevřené formáty pro výměnu dat! 🎉 + +## Naše mise + +Naším cílem je vytvořit a podporovat komunitu, která se zasazuje o: +- Zpracování a podporu otevřených formátů pro výměnu dat +- Transparentnost a dostupnost dat +- Standardizaci a interoperabilitu +- Sdílení znalostí a osvětu + +## Jak můžete přispět + +### Nahlášení chyb + +Pokud najdete chybu, vytvořte issue s následujícími informacemi: +- Jasný a popisný název +- Podrobný popis problému +- Kroky k reprodukci +- Očekávané a skutečné chování +- Snímky obrazovky, pokud je to relevantní +- Informace o prostředí (OS, verze prohlížeče, atd.) + +### Návrhy nových funkcí + +Máme rádi nové nápady! Pro návrh nové funkce: +1. Nejprve zkontrolujte, zda už podobný návrh neexistuje +2. Vytvořte issue s podrobným popisem +3. Vysvětlete, jak by funkce podpořila práci s otevřenými formáty +4. Popište případné použití (use cases) + +### Přispívání kódem + +1. **Fork** repozitáře +2. **Vytvořte branch** pro vaši funkci (`git checkout -b feature/AmazingFeature`) +3. **Commitujte** své změny (`git commit -m 'Add some AmazingFeature'`) +4. **Push** do branch (`git push origin feature/AmazingFeature`) +5. **Otevřete Pull Request** + +### Standardy kódu + +- Pište čistý, čitelný a dobře dokumentovaný kód +- Dodržujte existující styl kódu v projektu +- Přidejte testy pro nové funkce +- Ujistěte se, že všechny testy prochází +- Aktualizujte dokumentaci podle potřeby + +### Práce s otevřenými formáty + +Při práci s daty preferujeme: +- **JSON** - pro strukturovaná data a API +- **CSV** - pro tabulková data +- **XML** - pro komplexní hierarchická data +- **YAML** - pro konfiguraci +- **Markdown** - pro dokumentaci +- **SVG** - pro vektorovou grafiku + +Vyhýbejte se proprietárním formátům, pokud existuje otevřená alternativa. + +### Dokumentace + +Dobrá dokumentace je klíčová! Přispívejte: +- Vylepšením existující dokumentace +- Přidáním příkladů použití +- Překladem do dalších jazyků +- Vytvářením tutoriálů a průvodců + +### Revize kódu + +Všechny pull requesty procházejí revizí. Při revizi: +- Buďte konstruktivní a vstřícní +- Zaměřte se na kód, ne na člověka +- Vysvětlete své návrhy +- Oceňte dobrou práci + +## Komunikace + +- **Issues** - pro bug reports a feature requests +- **Pull Requests** - pro příspěvky kódu +- **Discussions** - pro obecné dotazy a diskuze + +## Kodex chování + +Tento projekt dodržuje [Kodex chování](CODE_OF_CONDUCT.md). Účastí se očekává, že budete tento kodex dodržovat. Prosím, nahlaste nepřijatelné chování. + +## Licence + +Přispěním do tohoto projektu souhlasíte s tím, že vaše příspěvky budou licencovány pod stejnou licencí jako projekt. + +## Děkujeme! + +Vaše příspěvky dělají tuto komunitu skvělým místem pro učení, inspiraci a tvorbu. Děkujeme za váš čas! ❤️ diff --git a/README.md b/README.md index a46ae92..04f7986 100644 --- a/README.md +++ b/README.md @@ -1 +1,73 @@ -# .github \ No newline at end of file +# Tabulky - Komunita pro otevřené formáty dat + +Vítejte v komunitě **Tabulky**, která se věnuje zpracování a podpoře otevřených formátů pro výměnu dat! 🚀 + +## 🎯 Naše mise + +Vytváříme komunitu, která: +- 📊 Podporuje **otevřené formáty** pro výměnu dat (JSON, CSV, XML, YAML) +- 🔓 Prosazuje **transparentnost a dostupnost** dat +- 🤝 Buduje **standardizaci a interoperabilitu** mezi systémy +- 📚 Sdílí **znalosti a osvětu** o otevřených datech +- 🌍 Podporuje **open source** a otevřené standardy + +## 🌟 Proč otevřené formáty? + +Otevřené formáty dat jsou klíčové pro: +- **Interoperabilitu**: Snadná výměna dat mezi různými systémy +- **Dlouhodobou dostupnost**: Data zůstávají přístupná bez závislosti na proprietárním softwaru +- **Transparentnost**: Každý může porozumět struktuře a obsahu dat +- **Inovace**: Otevřené standardy umožňují rychlejší vývoj nových řešení + +## 🚀 Zapojte se + +### Pro přispěvatele + +Přečtěte si [průvodce přispíváním](CONTRIBUTING.md) a staňte se součástí komunity! + +### Pro uživatele + +- 📖 Prostudujte [dokumentaci](https://github.com/tabulky/.github) +- 💬 Připojte se k [diskuzím](../../discussions) +- 🐛 Nahlaste [issues](../../issues) +- 📧 Získejte [podporu](SUPPORT.md) + +## 📋 Komunitní dokumenty + +- [Kodex chování](CODE_OF_CONDUCT.md) - Pravidla naší komunity +- [Průvodce přispíváním](CONTRIBUTING.md) - Jak přispět do projektu +- [Bezpečnostní zásady](SECURITY.md) - Jak nahlásit bezpečnostní problémy +- [Podpora](SUPPORT.md) - Kde získat pomoc + +## 🛠️ Podporované formáty + +Naše komunita se zaměřuje na následující otevřené formáty: + +| Formát | Použití | Standardy | +|--------|---------|-----------| +| **JSON** | Strukturovaná data, API | [RFC 8259](https://tools.ietf.org/html/rfc8259), [JSON Schema](https://json-schema.org/) | +| **CSV** | Tabulková data | [RFC 4180](https://tools.ietf.org/html/rfc4180) | +| **XML** | Hierarchická data | [W3C XML](https://www.w3.org/XML/) | +| **YAML** | Konfigurace, lidsky čitelná data | [YAML 1.2](https://yaml.org/) | +| **Markdown** | Dokumentace | [CommonMark](https://commonmark.org/) | + +## 🌍 Komunita + +Tato organizace slouží jako centrální místo pro: +- 🔧 Nástroje pro práci s otevřenými formáty +- 📊 Převodníky mezi formáty +- ✅ Validátory a schema definice +- 📚 Vzdělávací materiály a tutoriály +- 🤝 Sdílení best practices + +## 📜 Licence + +Projekty v této organizaci jsou zpravidla publikovány pod otevřenými licencemi jako MIT, Apache 2.0 nebo GPL v3, pokud není uvedeno jinak. + +## 🙏 Poděkování + +Děkujeme všem přispěvatelům, kteří pomáhají budovat tuto komunitu a podporovat otevřené formáty dat! + +--- + +**Připojte se k nám a pomozte vytvořit otevřenější a propojenější svět dat!** 💙 \ No newline at end of file diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..2ef7ef2 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,92 @@ +# Bezpečnostní zásady + +## Hlášení bezpečnostních zranitelností + +Bezpečnost našich projektů a dat našich uživatelů bereme velmi vážně. Pokud jste našli bezpečnostní zranitelnost, oceníme vaši pomoc při jejím zodpovědném nahlášení. + +### Jak nahlásit bezpečnostní problém + +**Prosím, NEHLASTE bezpečnostní zranitelnosti prostřednictvím veřejných GitHub issues.** + +Místo toho použijte jednu z následujících metod: + +1. **GitHub Security Advisories** (preferováno) + - Přejděte na záložku "Security" v repozitáři + - Klikněte na "Report a vulnerability" + - Vyplňte formulář s podrobnostmi + +2. **Soukromý email** + - Kontaktujte bezpečnostní tým projektu + - Uveďte "SECURITY" v předmětu emailu + +### Co zahrnout do hlášení + +Pomozte nám lépe porozumět problému tím, že zahrnete: + +- Typ zranitelnosti (např. SQL injection, XSS, atd.) +- Úplné cesty souborů souvisejících se zranitelností +- Umístění dotčeného kódu (tag/branch/commit nebo přímý URL) +- Jakákoli speciální konfigurace potřebná k reprodukci problému +- Podrobné kroky k reprodukci zranitelnosti +- Proof-of-concept nebo exploit kód (pokud je možný) +- Dopad zranitelnosti a jak by ji mohl útočník zneužít + +### Co můžete očekávat + +- **Potvrzení**: Potvrdíme přijetí vašeho hlášení do 48 hodin +- **Komunikace**: Budeme vás informovat o postupu řešení +- **Oprava**: Budeme pracovat na opravě co nejrychleji +- **Zveřejnění**: Zveřejníme opravu a oceníme vaši pomoc (pokud si to budete přát) + +## Podporované verze + +| Verze | Podporovaná | +| ----- | ----------- | +| Aktuální | ✅ | +| Starší verze | ❌ | + +## Bezpečnostní osvědčené postupy + +### Pro uživatele + +- Vždy používejte nejnovější verzi +- Pravidelně aktualizujte závislosti +- Neukládejte citlivá data v repositářích +- Používejte bezpečné přenosové protokoly (HTTPS, SSH) + +### Pro přispěvatele + +- Nikdy necommitujte citlivá data (klíče, hesla, tokeny) +- Používejte `.gitignore` pro vyloučení konfiguračních souborů +- Validujte a sanitizujte všechny vstupy +- Dodržujte zásadu nejmenších oprávnění +- Pravidelně kontrolujte závislosti na známé zranitelnosti + +### Bezpečnost dat + +Při práci s otevřenými formáty dat: + +- **Validace**: Vždy validujte vstupní data podle schématu +- **Sanitizace**: Čistěte data před zpracováním +- **Šifrování**: Šifrujte citlivá data při přenosu i ukládání +- **Přístupová práva**: Nastavte správná oprávnění pro soubory a adresáře +- **Anonymizace**: Odstraňte osobní údaje z veřejných dat + +## Bezpečnostní aktualizace + +Sledujte bezpečnostní aktualizace: +- GitHub Security Advisories +- Dependabot alerts +- Automatické bezpečnostní updaty + +## Zodpovědné zveřejnění + +Dodržujeme zásady zodpovědného zveřejnění: + +1. Bezpečnostní problémy nebudou veřejně zveřejněny, dokud nebude k dispozici oprava +2. Ocenime výzkumníky, kteří odpovědně nahlásí problémy +3. Poskytneme dostatek času na aktualizaci před veřejným zveřejněním + +## Poděkování + +Děkujeme bezpečnostnímu výzkumu komunity za pomoc udržet naše projekty bezpečné! 🙏 diff --git a/SUPPORT.md b/SUPPORT.md new file mode 100644 index 0000000..52356ae --- /dev/null +++ b/SUPPORT.md @@ -0,0 +1,56 @@ +# Podpora + +Děkujeme za používání našich projektů zaměřených na otevřené formáty pro výměnu dat! + +## Jak získat pomoc + +### 📚 Dokumentace + +Nejprve se podívejte do dokumentace projektu. Většina běžných otázek je tam zodpovězena. + +### 💬 Discussions + +Pro obecné dotazy, diskuze a sdílení nápadů použijte [GitHub Discussions](../../discussions): +- **Q&A** - Pokládejte otázky a hledejte odpovědi +- **Ideas** - Sdílejte nápady a návrhy +- **Show and Tell** - Ukažte, co jste vytvořili +- **General** - Obecné diskuze o otevřených formátech + +### 🐛 Issues + +Pokud jste našli bug nebo chcete navrhnout novou funkci: +1. Zkontrolujte [existující issues](../../issues) +2. Pokud problém ještě není nahlášen, [vytvořte nový issue](../../issues/new) + +### 📧 Kontakt + +Pro citlivé záležitosti nebo soukromé dotazy nás můžete kontaktovat přímo. + +## Co můžete očekávat + +- **Odpověď na issues**: obvykle do 48 hodin +- **Odpověď na pull requests**: obvykle do 72 hodin +- **Community support**: kdykoliv od ostatních členů komunity + +## Zdroje + +### Otevřené formáty dat + +- **JSON**: [json.org](https://www.json.org/) +- **CSV**: [RFC 4180](https://tools.ietf.org/html/rfc4180) +- **XML**: [W3C XML](https://www.w3.org/XML/) +- **YAML**: [yaml.org](https://yaml.org/) + +### Osvěta a standardy + +- **Open Data Handbook**: Průvodce otevřenými daty +- **Schema.org**: Slovníky pro strukturovaná data +- **JSON Schema**: Validace JSON dat + +## Přispívání + +Chcete pomoci ostatním? Přečtěte si [CONTRIBUTING.md](CONTRIBUTING.md) a staňte se součástí naší komunity! + +## Kodex chování + +Tento projekt dodržuje [Kodex chování](CODE_OF_CONDUCT.md). Očekáváme od všech účastníků respektující a konstruktivní chování.