From ee74a1caf32f4fab28306048b5a40447040dabd3 Mon Sep 17 00:00:00 2001 From: Elliott de Launay Date: Wed, 10 Jun 2026 22:14:11 +0000 Subject: [PATCH 1/2] docs(CONTRIBUTO): updating guidelines --- CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/ca/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/de/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/es/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/fr/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/hi/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/id/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/it/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/ja/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/ko/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/nl/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/pl/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/pt-BR/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/ru/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/tr/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/vi/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/zh-CN/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ locales/zh-TW/CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++ 18 files changed, 504 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index aff26a1276..e47cee2311 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code is a community-driven project, and we deeply value every contribution. - [Before You Contribute](#before-you-contribute) - [Finding & Planning Your Contribution](#finding--planning-your-contribution) - [Development & Submission Process](#development--submission-process) +- [Pull Request Expectations](#pull-request-expectations) +- [AI-Assisted Contributions](#ai-assisted-contributions) - [Legal](#legal) ## Before You Contribute @@ -136,6 +138,32 @@ pnpm install - **Weekly In-depth Review:** Comprehensive assessment. - **Iterate promptly** based on feedback. +### Pull Request Expectations + +Pull requests should be reviewable, tested, and maintainable. Before opening a PR, please make sure that: + +- The change is scoped to a specific issue, bug, or improvement. +- You can explain what the change does and why it is correct. +- You have tested the change locally where practical. +- You are willing to respond to review feedback and make reasonable follow-up changes. +- The PR does not require maintainers to substantially rewrite, redesign, or take ownership of the implementation before it can be merged. + +Maintainers may close PRs that are incomplete, too broad, inactive, not aligned with the project direction, or that create disproportionate review or maintenance burden. Closing a PR is not a judgment on the contributor; it means the change is not currently mergeable in its present form. + +### AI-Assisted Contributions + +Use of AI tools is allowed, but contributors remain fully responsible for their submissions. + +If you use AI tools to help create a PR, you must: + +- Review and understand every meaningful change. +- Be able to explain the implementation and tradeoffs in your own words. +- Test the change yourself where practical. +- Verify that generated code is correct, necessary, and compatible with the project license. +- Disclose meaningful AI assistance in the PR description when it materially contributed to the code, tests, or design. + +Please do not submit AI-generated changes that you do not understand, have not tested, or cannot maintain through review. Maintainers may close PRs that appear to be substantially AI-assisted but lack human verification, clear rationale, or review follow-through. + ## Legal By contributing, you agree your contributions will be licensed under the Apache 2.0 License, consistent with Zoo Code's licensing. diff --git a/locales/ca/CONTRIBUTING.md b/locales/ca/CONTRIBUTING.md index 7b277992c7..475cf38132 100644 --- a/locales/ca/CONTRIBUTING.md +++ b/locales/ca/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code és un projecte impulsat per la comunitat i valorem profundament cada c - [Abans de contribuir](#abans-de-contribuir) - [Trobar i planificar la vostra contribució](#trobar-i-planificar-la-vostra-contribució) - [Procés de desenvolupament i submissió](#procés-de-desenvolupament-i-submissió) +- [Expectatives de les sol·licituds d'extracció](#expectatives-de-les-sollicituds-dextracció) +- [Contribucions amb assistència d'IA](#contribucions-amb-assistència-dia) - [Legal](#legal) ## Abans de contribuir @@ -136,6 +138,32 @@ pnpm install - **Revisió setmanal en profunditat:** avaluació completa. - **Itereu ràpidament** en funció dels comentaris. +### Expectatives de les sol·licituds d'extracció + +Les sol·licituds d'extracció han de ser revisables, provades i mantenibles. Abans d'obrir una PR, assegureu-vos que: + +- El canvi s'adapta a un problema, error o millora específics. +- Podeu explicar què fa el canvi i per què és correcte. +- Heu provat el canvi localment on sigui pràctic. +- Esteu disposats a respondre als comentaris de la revisió i fer canvis raonables de seguiment. +- La PR no requereix que els mantenidors reescriguin, redissenyin o assumeixin la propietat substancial de la implementació abans de poder fusionar-la. + +Els mantenidors poden tancar les PR que estiguin incompletes, siguin massa àmplies, inactives, no estiguin alineades amb la direcció del projecte o que creïn una càrrega desproporcionada de revisió o manteniment. Tancar una PR no és un judici sobre el col·laborador; significa que el canvi no és fusionable en la seva forma actual. + +### Contribucions amb assistència d'IA + +L'ús d'eines d'IA és permès, però els col·laboradors continuen sent completament responsables de les seves aportacions. + +Si utiliseu eines d'IA per ajudar a crear una PR, heu de: + +- Revisar i comprendre cada canvi significatiu. +- Ser capaços d'explicar la implementació i els compromisos amb les vostres pròpies paraules. +- Provar el canvi vosaltres mateixos on sigui pràctic. +- Verificar que el codi generat és correcte, necessari i compatible amb la llicència del projecte. +- Revelar l'assistència significativa de la IA a la descripció de la PR quan hagi contribuït materialment al codi, les proves o el disseny. + +Si us plau, no envieu canvis generats per IA que no enteneu, no heu provat o no podeu mantenir durant la revisió. Els mantenidors poden tancar les PR que semblin substancialment assistides per IA però que manquin de verificació humana, raonament clar o seguiment de la revisió. + ## Legal En contribuir, accepteu que les vostres contribucions es llicenciaran sota la llicència Apache 2.0, d'acord amb la llicència de Zoo Code. diff --git a/locales/de/CONTRIBUTING.md b/locales/de/CONTRIBUTING.md index d43513dc2f..e91422f933 100644 --- a/locales/de/CONTRIBUTING.md +++ b/locales/de/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code ist ein von der Community getragenes Projekt, und wir schätzen jeden B - [Bevor du beiträgst](#bevor-du-beiträgst) - [Deinen Beitrag finden und planen](#deinen-beitrag-finden-und-planen) - [Entwicklungs- und Einreichungsprozess](#entwicklungs-und-einreichungsprozess) +- [Anforderungen an Pull Requests](#anforderungen-an-pull-requests) +- [KI-gestützte Beiträge](#ki-gestützte-beiträge) - [Rechtliches](#rechtliches) ## Bevor du beiträgst @@ -136,6 +138,32 @@ pnpm install - **Wöchentliche ausführliche Überprüfung:** Umfassende Bewertung. - **Iteriere umgehend** basierend auf dem Feedback. +### Anforderungen an Pull Requests + +Pull Requests müssen überprüfbar, getestet und wartbar sein. Stelle vor dem Öffnen eines PRs sicher, dass: + +- Die Änderung auf ein bestimmtes Issue, einen Bug oder eine Verbesserung beschränkt ist. +- Du erklären kannst, was die Änderung bewirkt und warum sie korrekt ist. +- Du die Änderung lokal getestet hast, soweit praktisch möglich. +- Du bereit bist, auf Review-Feedback zu antworten und angemessene Folgeanpassungen vorzunehmen. +- Der PR nicht erfordert, dass Betreuer die Implementierung vor dem Mergen wesentlich umschreiben, neu gestalten oder übernehmen. + +Betreuer können PRs schließen, die unvollständig, zu umfangreich, inaktiv, nicht mit der Projektrichtung abgestimmt sind oder einen unverhältnismäßigen Review- oder Wartungsaufwand verursachen. Das Schließen eines PRs ist kein Urteil über den Beitragenden; es bedeutet, dass die Änderung in ihrer aktuellen Form nicht mergebar ist. + +### KI-gestützte Beiträge + +Die Verwendung von KI-Tools ist erlaubt, aber Beitragende tragen die volle Verantwortung für ihre Einreichungen. + +Wenn du KI-Tools zur Erstellung eines PRs verwendest, musst du: + +- Jede wesentliche Änderung überprüfen und verstehen. +- Die Implementierung und die Kompromisse in eigenen Worten erklären können. +- Die Änderung selbst testen, soweit praktisch möglich. +- Sicherstellen, dass der generierte Code korrekt, notwendig und mit der Projektlizenz kompatibel ist. +- Wesentliche KI-Unterstützung in der PR-Beschreibung offenlegen, wenn sie maßgeblich zum Code, den Tests oder dem Design beigetragen hat. + +Bitte reiche keine KI-generierten Änderungen ein, die du nicht verstehst, nicht getestet hast oder die du nicht durch den Review-Prozess pflegen kannst. Betreuer können PRs schließen, die überwiegend KI-gestützt erscheinen, aber keine menschliche Überprüfung, klare Begründung oder Review-Nachverfolgung aufweisen. + ## Rechtliches Indem du einen Beitrag leistest, stimmst du zu, dass deine Beiträge unter der Apache-2.0-Lizenz lizenziert werden, die mit der Lizenzierung von Zoo Code übereinstimmt. diff --git a/locales/es/CONTRIBUTING.md b/locales/es/CONTRIBUTING.md index 649c09f240..e1d1b2cca5 100644 --- a/locales/es/CONTRIBUTING.md +++ b/locales/es/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code es un proyecto impulsado por la comunidad y valoramos profundamente cad - [Antes de contribuir](#antes-de-contribuir) - [Encontrar y planificar su contribución](#encontrar-y-planificar-su-contribución) - [Proceso de desarrollo y envío](#proceso-de-desarrollo-y-envío) +- [Expectativas de las solicitudes de extracción](#expectativas-de-las-solicitudes-de-extracción) +- [Contribuciones asistidas por IA](#contribuciones-asistidas-por-ia) - [Legal](#legal) ## Antes de contribuir @@ -136,6 +138,32 @@ pnpm install - **Revisión semanal en profundidad:** evaluación exhaustiva. - **Itere rápidamente** en función de los comentarios. +### Expectativas de las solicitudes de extracción + +Las solicitudes de extracción deben ser revisables, probadas y mantenibles. Antes de abrir una PR, asegúrese de que: + +- El cambio se limita a un problema, error o mejora específicos. +- Puede explicar qué hace el cambio y por qué es correcto. +- Ha probado el cambio localmente donde sea práctico. +- Está dispuesto a responder a los comentarios de revisión y realizar cambios de seguimiento razonables. +- La PR no requiere que los mantenedores reescriban, rediseñen o asuman sustancialmente la propiedad de la implementación antes de poder fusionarla. + +Los mantenedores pueden cerrar PRs que estén incompletas, sean demasiado amplias, inactivas, no estén alineadas con la dirección del proyecto o que creen una carga desproporcionada de revisión o mantenimiento. Cerrar una PR no es un juicio sobre el colaborador; significa que el cambio no es fusionable en su forma actual. + +### Contribuciones asistidas por IA + +El uso de herramientas de IA está permitido, pero los colaboradores siguen siendo completamente responsables de sus aportaciones. + +Si utiliza herramientas de IA para ayudar a crear una PR, debe: + +- Revisar y comprender cada cambio significativo. +- Ser capaz de explicar la implementación y las compensaciones con sus propias palabras. +- Probar el cambio usted mismo donde sea práctico. +- Verificar que el código generado sea correcto, necesario y compatible con la licencia del proyecto. +- Revelar la asistencia significativa de la IA en la descripción de la PR cuando haya contribuido materialmente al código, las pruebas o el diseño. + +Por favor, no envíe cambios generados por IA que no entienda, no haya probado o que no pueda mantener durante la revisión. Los mantenedores pueden cerrar las PRs que parezcan sustancialmente asistidas por IA pero que carezcan de verificación humana, justificación clara o seguimiento de la revisión. + ## Legal Al contribuir, acepta que sus contribuciones se licenciarán bajo la Licencia Apache 2.0, de acuerdo con la licencia de Zoo Code. diff --git a/locales/fr/CONTRIBUTING.md b/locales/fr/CONTRIBUTING.md index fb23ad4a6d..d3712d96e5 100644 --- a/locales/fr/CONTRIBUTING.md +++ b/locales/fr/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code est un projet communautaire, et nous apprécions profondément chaque c - [Avant de contribuer](#avant-de-contribuer) - [Trouver et planifier votre contribution](#trouver-et-planifier-votre-contribution) - [Processus de développement et de soumission](#processus-de-développement-et-de-soumission) +- [Attentes relatives aux Pull Requests](#attentes-relatives-aux-pull-requests) +- [Contributions assistées par IA](#contributions-assistées-par-ia) - [Légal](#légal) ## Avant de contribuer @@ -136,6 +138,32 @@ pnpm install - **Révision hebdomadaire approfondie :** Évaluation complète. - **Itérez rapidement** en fonction des commentaires. +### Attentes relatives aux Pull Requests + +Les Pull Requests doivent être révisables, testées et maintenables. Avant d'ouvrir une PR, assurez-vous que : + +- Le changement est limité à un problème, un bug ou une amélioration spécifique. +- Vous pouvez expliquer ce que fait le changement et pourquoi il est correct. +- Vous avez testé le changement localement dans la mesure du possible. +- Vous êtes prêt à répondre aux retours de la révision et à effectuer des modifications de suivi raisonnables. +- La PR ne nécessite pas que les mainteneurs réécrivent, reconçoivent ou prennent en charge de manière substantielle l'implémentation avant de pouvoir la fusionner. + +Les mainteneurs peuvent fermer les PRs qui sont incomplètes, trop larges, inactives, non alignées avec la direction du projet ou qui créent une charge de révision ou de maintenance disproportionnée. Fermer une PR n'est pas un jugement sur le contributeur ; cela signifie que le changement n'est pas fusionnable dans sa forme actuelle. + +### Contributions assistées par IA + +L'utilisation d'outils d'IA est autorisée, mais les contributeurs restent entièrement responsables de leurs soumissions. + +Si vous utilisez des outils d'IA pour aider à créer une PR, vous devez : + +- Réviser et comprendre chaque modification significative. +- Être capable d'expliquer l'implémentation et les compromis avec vos propres mots. +- Tester vous-même le changement dans la mesure du possible. +- Vérifier que le code généré est correct, nécessaire et compatible avec la licence du projet. +- Divulguer l'assistance significative de l'IA dans la description de la PR lorsqu'elle a contribué de manière substantielle au code, aux tests ou à la conception. + +Veuillez ne pas soumettre de modifications générées par IA que vous ne comprenez pas, que vous n'avez pas testées ou que vous ne pouvez pas maintenir lors de la révision. Les mainteneurs peuvent fermer les PRs qui semblent substantiellement assistées par IA mais qui manquent de vérification humaine, de justification claire ou de suivi de la révision. + ## Légal En contribuant, vous acceptez que vos contributions soient sous licence Apache 2.0, conformément à la licence de Zoo Code. diff --git a/locales/hi/CONTRIBUTING.md b/locales/hi/CONTRIBUTING.md index 5435f1d7f6..14071fab87 100644 --- a/locales/hi/CONTRIBUTING.md +++ b/locales/hi/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code एक समुदाय-संचालित परियोजन - [योगदान करने से पहले](#योगदान-करने-से-पहले) - [अपना योगदान ढूँढना और योजना बनाना](#अपना-योगदान-ढूँढना-और-योजना-बनाना) - [विकास और प्रस्तुत करने की प्रक्रिया](#विकास-और-प्रस्तुत-करने-की-प्रक्रिया) +- [पुल अनुरोध की अपेक्षाएँ](#पुल-अनुरोध-की-अपेक्षाएँ) +- [एआई-सहायता प्राप्त योगदान](#एआई-सहायता-प्राप्त-योगदान) - [कानूनी](#कानूनी) ## योगदान करने से पहले @@ -136,6 +138,32 @@ pnpm install - **साप्ताहिक गहन समीक्षा:** व्यापक मूल्यांकन। - **प्रतिक्रिया के आधार पर तुरंत पुनरावृति करें**। +### पुल अनुरोध की अपेक्षाएँ + +पुल अनुरोध समीक्षा योग्य, परीक्षित और रखरखाव योग्य होने चाहिए। पीआर खोलने से पहले, सुनिश्चित करें कि: + +- परिवर्तन किसी विशिष्ट समस्या, बग या सुधार तक सीमित है। +- आप समझा सकते हैं कि परिवर्तन क्या करता है और यह सही क्यों है। +- आपने जहाँ व्यावहारिक हो, परिवर्तन को स्थानीय रूप से परीक्षित किया है। +- आप समीक्षा प्रतिक्रिया का जवाब देने और उचित अनुवर्ती परिवर्तन करने के लिए तैयार हैं। +- पीआर के लिए अनुरक्षकों को विलय से पहले कार्यान्वयन को मूल रूप से फिर से लिखने, पुनर्डिज़ाइन करने या स्वामित्व लेने की आवश्यकता नहीं है। + +अनुरक्षक ऐसी पीआर को बंद कर सकते हैं जो अधूरी, बहुत व्यापक, निष्क्रिय, परियोजना की दिशा के अनुरूप नहीं, या जो असंगत समीक्षा या रखरखाव बोझ पैदा करती हों। पीआर को बंद करना योगदानकर्ता पर कोई निर्णय नहीं है; इसका अर्थ है कि परिवर्तन अपने वर्तमान स्वरूप में विलय योग्य नहीं है। + +### एआई-सहायता प्राप्त योगदान + +एआई उपकरणों का उपयोग अनुमत है, लेकिन योगदानकर्ता अपनी प्रस्तुतियों के लिए पूरी तरह जिम्मेदार रहते हैं। + +यदि आप पीआर बनाने में सहायता के लिए एआई उपकरणों का उपयोग करते हैं, तो आपको: + +- हर महत्वपूर्ण परिवर्तन की समीक्षा करनी और समझनी होगी। +- अपने शब्दों में कार्यान्वयन और ट्रेडऑफ़ समझाने में सक्षम होना होगा। +- जहाँ व्यावहारिक हो, परिवर्तन को स्वयं परीक्षित करना होगा। +- यह सत्यापित करना होगा कि उत्पन्न कोड सही, आवश्यक और परियोजना लाइसेंस के अनुकूल है। +- पीआर विवरण में महत्वपूर्ण एआई सहायता का खुलासा करना होगा जब इसने कोड, परीक्षण या डिज़ाइन में भौतिक रूप से योगदान दिया हो। + +कृपया ऐसे एआई-उत्पन्न परिवर्तन प्रस्तुत न करें जिन्हें आप नहीं समझते, परीक्षित नहीं किया है, या समीक्षा के दौरान बनाए नहीं रख सकते। अनुरक्षक ऐसी पीआर को बंद कर सकते हैं जो काफी हद तक एआई-सहायता प्राप्त प्रतीत होती हैं लेकिन मानवीय सत्यापन, स्पष्ट तर्क या समीक्षा अनुवर्ती का अभाव है। + ## कानूनी योगदान करके, आप सहमत हैं कि आपके योगदान अपाचे 2.0 लाइसेंस के तहत लाइसेंस प्राप्त होंगे, जो Zoo Code के लाइसेंस के अनुरूप है। diff --git a/locales/id/CONTRIBUTING.md b/locales/id/CONTRIBUTING.md index ee609f37d9..ec0cafb075 100644 --- a/locales/id/CONTRIBUTING.md +++ b/locales/id/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code adalah proyek yang digerakkan oleh komunitas, dan kami sangat mengharga - [Sebelum Anda Berkontribusi](#sebelum-anda-berkontribusi) - [Menemukan & Merencanakan Kontribusi Anda](#menemukan--merencanakan-kontribusi-anda) - [Proses Pengembangan & Pengajuan](#proses-pengembangan--pengajuan) +- [Ekspektasi Pull Request](#ekspektasi-pull-request) +- [Kontribusi Berbantuan AI](#kontribusi-berbantuan-ai) - [Hukum](#hukum) ## Sebelum Anda Berkontribusi @@ -136,6 +138,32 @@ pnpm install - **Tinjauan Mendalam Mingguan:** Penilaian komprehensif. - **Iterasi dengan cepat** berdasarkan umpan balik. +### Ekspektasi Pull Request + +Pull Request harus dapat ditinjau, diuji, dan dapat dipelihara. Sebelum membuka PR, pastikan bahwa: + +- Perubahan dibatasi pada masalah, bug, atau peningkatan tertentu. +- Anda dapat menjelaskan apa yang dilakukan perubahan dan mengapa hal itu benar. +- Anda telah menguji perubahan secara lokal jika memungkinkan. +- Anda bersedia merespons umpan balik ulasan dan melakukan perubahan tindak lanjut yang wajar. +- PR tidak mengharuskan pengelola untuk menulis ulang, mendesain ulang, atau mengambil alih kepemilikan implementasi secara substansial sebelum dapat digabungkan. + +Pengelola dapat menutup PR yang tidak lengkap, terlalu luas, tidak aktif, tidak selaras dengan arah proyek, atau yang menciptakan beban ulasan atau pemeliharaan yang tidak proporsional. Menutup PR bukan merupakan penilaian terhadap kontributor; artinya perubahan tersebut tidak dapat digabungkan dalam bentuknya saat ini. + +### Kontribusi Berbantuan AI + +Penggunaan alat AI diperbolehkan, tetapi kontributor tetap sepenuhnya bertanggung jawab atas kiriman mereka. + +Jika Anda menggunakan alat AI untuk membantu membuat PR, Anda harus: + +- Meninjau dan memahami setiap perubahan yang berarti. +- Mampu menjelaskan implementasi dan pertukaran dengan kata-kata Anda sendiri. +- Menguji perubahan sendiri jika memungkinkan. +- Memverifikasi bahwa kode yang dihasilkan benar, diperlukan, dan kompatibel dengan lisensi proyek. +- Mengungkapkan bantuan AI yang signifikan dalam deskripsi PR ketika berkontribusi secara material pada kode, pengujian, atau desain. + +Jangan mengirimkan perubahan yang dihasilkan AI yang tidak Anda pahami, belum Anda uji, atau tidak dapat Anda pertahankan melalui ulasan. Pengelola dapat menutup PR yang tampaknya sebagian besar dibantu AI tetapi tidak memiliki verifikasi manusia, alasan yang jelas, atau tindak lanjut ulasan. + ## Hukum Dengan berkontribusi, Anda setuju bahwa kontribusi Anda akan dilisensikan di bawah Lisensi Apache 2.0, sesuai dengan lisensi Zoo Code. diff --git a/locales/it/CONTRIBUTING.md b/locales/it/CONTRIBUTING.md index 9b2ef9f17e..5cb0e6f0e9 100644 --- a/locales/it/CONTRIBUTING.md +++ b/locales/it/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code è un progetto guidato dalla comunità e apprezziamo profondamente ogni - [Prima di contribuire](#prima-di-contribuire) - [Trovare e pianificare il tuo contributo](#trovare-e-pianificare-il-tuo-contributo) - [Processo di sviluppo e invio](#processo-di-sviluppo-e-invio) +- [Aspettative sulle Pull Request](#aspettative-sulle-pull-request) +- [Contributi assistiti da IA](#contributi-assistiti-da-ia) - [Legale](#legale) ## Prima di contribuire @@ -136,6 +138,32 @@ pnpm install - **Revisione approfondita settimanale:** valutazione completa. - **Itera prontamente** in base al feedback. +### Aspettative sulle Pull Request + +Le Pull Request devono essere revisionabili, testate e manutenibili. Prima di aprire una PR, assicurati che: + +- La modifica sia limitata a un issue, bug o miglioramento specifico. +- Tu possa spiegare cosa fa la modifica e perché è corretta. +- Tu abbia testato la modifica localmente dove pratico. +- Tu sia disposto a rispondere al feedback della revisione e ad apportare ragionevoli modifiche di follow-up. +- La PR non richieda ai manutentori di riscrivere, riprogettare o assumere sostanzialmente la proprietà dell'implementazione prima di poter essere unita. + +I manutentori possono chiudere le PR che sono incomplete, troppo ampie, inattive, non allineate con la direzione del progetto o che creano un onere di revisione o manutenzione sproporzionato. La chiusura di una PR non è un giudizio sul contributore; significa che la modifica non è attualmente unibile nella sua forma attuale. + +### Contributi assistiti da IA + +L'uso di strumenti di IA è consentito, ma i contributori rimangono completamente responsabili delle loro submissions. + +Se utilizzi strumenti di IA per aiutare a creare una PR, devi: + +- Revisionare e comprendere ogni modifica significativa. +- Essere in grado di spiegare l'implementazione e i compromessi con parole tue. +- Testare tu stesso la modifica dove pratico. +- Verificare che il codice generato sia corretto, necessario e compatibile con la licenza del progetto. +- Divulgare l'assistenza significativa dell'IA nella descrizione della PR quando ha contribuito materialmente al codice, ai test o al design. + +Si prega di non inviare modifiche generate dall'IA che non si comprendono, non si sono testate o che non si possono mantenere durante la revisione. I manutentori possono chiudere le PR che sembrano sostanzialmente assistite dall'IA ma prive di verifica umana, motivazione chiara o follow-through della revisione. + ## Legale Contribuendo, accetti che i tuoi contributi siano concessi in licenza con la licenza Apache 2.0, in coerenza con la licenza di Zoo Code. diff --git a/locales/ja/CONTRIBUTING.md b/locales/ja/CONTRIBUTING.md index 41a491eab6..7eb30303e6 100644 --- a/locales/ja/CONTRIBUTING.md +++ b/locales/ja/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Codeはコミュニティ主導のプロジェクトであり、すべての - [貢献する前に](#貢献する前に) - [貢献内容の検索と計画](#貢献内容の検索と計画) - [開発と提出のプロセス](#開発と提出のプロセス) +- [プルリクエストへの期待](#プルリクエストへの期待) +- [AIを利用した貢献](#aiを利用した貢献) - [法務](#法務) ## 貢献する前に @@ -136,6 +138,32 @@ pnpm install - **毎週の詳細なレビュー：** 包括的な評価。 - フィードバックに基づいて**迅速に反復**します。 +### プルリクエストへの期待 + +プルリクエストはレビュー可能で、テストされており、保守可能である必要があります。PRを開く前に、以下を確認してください。 + +- 変更は特定のイシュー、バグ、または改善に限定されている。 +- 変更が何をするのか、なぜ正しいのかを説明できる。 +- 可能な限りローカルで変更をテストした。 +- レビューフィードバックに応答し、合理的なフォローアップ変更を行う意思がある。 +- PRをマージする前に、メンテナーが実装を大幅に書き直したり、再設計したり、所有権を取得したりする必要がない。 + +メンテナーは、不完全なPR、範囲が広すぎるPR、非活性なPR、プロジェクトの方向性に沿っていないPR、または不釣り合いなレビューや保守の負担を生じさせるPRを閉じることができます。PRを閉じることはコントリビューターへの判断ではありません。それは変更が現在の形ではマージできないことを意味します。 + +### AIを利用した貢献 + +AIツールの使用は許可されていますが、コントリビューターは自分の提出物に対して完全な責任を負います。 + +PRの作成にAIツールを使用する場合は、以下が必要です。 + +- すべての重要な変更をレビューして理解する。 +- 実装とトレードオフを自分の言葉で説明できる。 +- 可能な限り自分で変更をテストする。 +- 生成されたコードが正確で、必要であり、プロジェクトのライセンスと互換性があることを確認する。 +- コード、テスト、または設計に実質的に貢献した場合は、PRの説明でAIの重要な支援を開示する。 + +理解していない、テストしていない、またはレビューを通じて維持できないAI生成の変更を提出しないでください。メンテナーは、実質的にAI支援と思われるが、人間による検証、明確な根拠、またはレビューのフォロースルーが欠如しているPRを閉じることができます。 + ## 法務 貢献することにより、あなたの貢献がZoo Codeのライセンスと一致するApache 2.0ライセンスの下でライセンスされることに同意したことになります。 diff --git a/locales/ko/CONTRIBUTING.md b/locales/ko/CONTRIBUTING.md index 70c23edf60..22fd425fc9 100644 --- a/locales/ko/CONTRIBUTING.md +++ b/locales/ko/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code는 커뮤니티 기반 프로젝트이며 모든 기여를 소중하게 - [기여하기 전에](#기여하기-전에) - [기여 찾기 및 계획하기](#기여-찾기-및-계획하기) - [개발 및 제출 절차](#개발-및-제출-절차) +- [풀 리퀘스트 기대 사항](#풀-리퀘스트-기대-사항) +- [AI 보조 기여](#ai-보조-기여) - [법률](#법률) ## 기여하기 전에 @@ -136,6 +138,32 @@ pnpm install - **매주 심층 검토:** 포괄적인 평가. - 피드백을 바탕으로 **신속하게 반복**합니다. +### 풀 리퀘스트 기대 사항 + +풀 리퀘스트는 검토 가능하고, 테스트되었으며, 유지 관리 가능해야 합니다. PR을 열기 전에 다음을 확인하세요. + +- 변경 사항이 특정 이슈, 버그 또는 개선 사항으로 범위가 제한되어 있습니다. +- 변경 사항이 무엇을 하는지, 왜 올바른지 설명할 수 있습니다. +- 가능한 경우 로컬에서 변경 사항을 테스트했습니다. +- 검토 피드백에 응답하고 합리적인 후속 변경 사항을 만들 의향이 있습니다. +- PR을 병합하기 전에 유지 관리자가 구현을 실질적으로 재작성, 재설계하거나 소유권을 가져갈 필요가 없습니다. + +유지 관리자는 불완전하거나, 너무 광범위하거나, 비활성이거나, 프로젝트 방향에 맞지 않거나, 불균형한 검토 또는 유지 관리 부담을 초래하는 PR을 닫을 수 있습니다. PR을 닫는 것은 기여자에 대한 판단이 아닙니다. 이는 변경 사항이 현재 형태로는 병합할 수 없음을 의미합니다. + +### AI 보조 기여 + +AI 도구 사용은 허용되지만 기여자는 자신의 제출물에 대해 전적으로 책임을 집니다. + +PR 작성에 AI 도구를 사용하는 경우 다음을 해야 합니다. + +- 모든 중요한 변경 사항을 검토하고 이해합니다. +- 자신의 말로 구현과 트레이드오프를 설명할 수 있어야 합니다. +- 가능한 경우 직접 변경 사항을 테스트합니다. +- 생성된 코드가 올바르고, 필요하며, 프로젝트 라이선스와 호환되는지 확인합니다. +- 코드, 테스트 또는 설계에 실질적으로 기여한 경우 PR 설명에서 AI의 중요한 지원을 공개합니다. + +이해하지 못하거나, 테스트하지 않았거나, 검토를 통해 유지 관리할 수 없는 AI 생성 변경 사항을 제출하지 마세요. 유지 관리자는 실질적으로 AI 보조로 보이지만 인간의 검증, 명확한 근거 또는 검토 후속 조치가 부족한 PR을 닫을 수 있습니다. + ## 법률 기여함으로써 귀하는 귀하의 기여가 Zoo Code의 라이선스와 일치하는 Apache 2.0 라이선스에 따라 라이선스가 부여된다는 데 동의합니다. diff --git a/locales/nl/CONTRIBUTING.md b/locales/nl/CONTRIBUTING.md index 7ae2c493a4..e67d8f33d6 100644 --- a/locales/nl/CONTRIBUTING.md +++ b/locales/nl/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code is een door de gemeenschap gedreven project en we waarderen elke bijdra - [Voordat je bijdraagt](#voordat-je-bijdraagt) - [Je bijdrage vinden en plannen](#je-bijdrage-vinden-en-plannen) - [Ontwikkelings- en indieningsproces](#ontwikkelings-en-indieningsproces) +- [Verwachtingen voor Pull Requests](#verwachtingen-voor-pull-requests) +- [Door AI ondersteunde bijdragen](#door-ai-ondersteunde-bijdragen) - [Juridisch](#juridisch) ## Voordat je bijdraagt @@ -136,6 +138,32 @@ pnpm install - **Wekelijkse diepgaande beoordeling:** Uitgebreide beoordeling. - **Itereer snel** op basis van feedback. +### Verwachtingen voor Pull Requests + +Pull Requests moeten beoordeelbaar, getest en onderhoudbaar zijn. Zorg er voor het openen van een PR voor dat: + +- De wijziging beperkt is tot een specifiek issue, bug of verbetering. +- Je kunt uitleggen wat de wijziging doet en waarom het correct is. +- Je de wijziging lokaal hebt getest waar praktisch. +- Je bereid bent om te reageren op reviewfeedback en redelijke vervolgwijzigingen aan te brengen. +- De PR niet vereist dat onderhouders de implementatie wezenlijk herschrijven, herontwerpen of eigenaarschap overnemen voordat deze kan worden samengevoegd. + +Onderhouders kunnen PR's sluiten die onvolledig, te breed, inactief, niet in lijn met de projectrichting zijn, of die een onevenredige review- of onderhoudslast creëren. Het sluiten van een PR is geen oordeel over de bijdrager; het betekent dat de wijziging momenteel niet samenvoegbaar is in zijn huidige vorm. + +### Door AI ondersteunde bijdragen + +Het gebruik van AI-tools is toegestaan, maar bijdragers blijven volledig verantwoordelijk voor hun inzendingen. + +Als je AI-tools gebruikt om een PR te helpen maken, moet je: + +- Elke significante wijziging beoordelen en begrijpen. +- De implementatie en afwegingen in eigen woorden kunnen uitleggen. +- De wijziging zelf testen waar praktisch. +- Verifiëren dat de gegenereerde code correct, noodzakelijk en compatibel is met de projectlicentie. +- Significante AI-hulp in de PR-beschrijving vermelden wanneer dit materieel heeft bijgedragen aan de code, tests of het ontwerp. + +Dien geen AI-gegenereerde wijzigingen in die je niet begrijpt, niet hebt getest of die je niet kunt onderhouden tijdens de review. Onderhouders kunnen PR's sluiten die overwegend AI-ondersteund lijken maar geen menselijke verificatie, duidelijke motivatie of review-opvolging hebben. + ## Juridisch Door bij te dragen, ga je ermee akkoord dat je bijdragen onder de Apache 2.0-licentie worden gelicentieerd, in overeenstemming met de licentieverlening van Zoo Code. diff --git a/locales/pl/CONTRIBUTING.md b/locales/pl/CONTRIBUTING.md index 003f782116..7d758aa26f 100644 --- a/locales/pl/CONTRIBUTING.md +++ b/locales/pl/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code to projekt społecznościowy i głęboko cenimy każdy wkład. Aby uspr - [Zanim zaczniesz wnosić wkład](#zanim-zaczniesz-wnosić-wkład) - [Znajdowanie i planowanie swojego wkładu](#znajdowanie-i-planowanie-swojego-wkładu) - [Proces rozwoju i przesyłania](#proces-rozwoju-i-przesyłania) +- [Oczekiwania dotyczące żądań ściągnięcia](#oczekiwania-dotyczące-żądań-ściągnięcia) +- [Wkłady wspomagane przez AI](#wkłady-wspomagane-przez-ai) - [Kwestie prawne](#kwestie-prawne) ## Zanim zaczniesz wnosić wkład @@ -136,6 +138,32 @@ pnpm install - **Cotygodniowy dogłębny przegląd:** Kompleksowa ocena. - **Szybko iteruj** w oparciu o opinie. +### Oczekiwania dotyczące żądań ściągnięcia + +Żądania ściągnięcia powinny być możliwe do przejrzenia, przetestowane i łatwe w utrzymaniu. Przed otwarciem PR upewnij się, że: + +- Zmiana jest ograniczona do konkretnego zgłoszenia, błędu lub ulepszenia. +- Możesz wyjaśnić, co robi zmiana i dlaczego jest poprawna. +- Przetestowałeś zmianę lokalnie tam, gdzie jest to praktyczne. +- Jesteś gotowy do odpowiadania na opinie z przeglądu i wprowadzania rozsądnych zmian następczych. +- PR nie wymaga od opiekunów zasadniczego przepisania, przeprojektowania ani przejęcia własności implementacji przed scaleniem. + +Opiekunowie mogą zamykać PR, które są niekompletne, zbyt szerokie, nieaktywne, niezgodne z kierunkiem projektu lub tworzące nieproporcjonalne obciążenie przeglądem lub konserwacją. Zamknięcie PR nie jest oceną współtwórcy; oznacza, że zmiana nie jest obecnie możliwa do scalenia w jej obecnej postaci. + +### Wkłady wspomagane przez AI + +Korzystanie z narzędzi AI jest dozwolone, ale współtwórcy pozostają w pełni odpowiedzialni za swoje zgłoszenia. + +Jeśli używasz narzędzi AI do pomocy przy tworzeniu PR, musisz: + +- Przejrzeć i zrozumieć każdą istotną zmianę. +- Być w stanie wyjaśnić implementację i kompromisy własnymi słowami. +- Samodzielnie przetestować zmianę tam, gdzie jest to praktyczne. +- Zweryfikować, że wygenerowany kod jest poprawny, konieczny i zgodny z licencją projektu. +- Ujawnić znaczącą pomoc AI w opisie PR, gdy w istotny sposób przyczyniła się do kodu, testów lub projektu. + +Prosimy o nieprzesyłanie zmian wygenerowanych przez AI, których nie rozumiesz, nie przetestowałeś lub których nie możesz utrzymać podczas przeglądu. Opiekunowie mogą zamykać PR, które wydają się w istotnym stopniu wspomagane przez AI, ale brakuje im weryfikacji człowieka, jasnego uzasadnienia lub kontynuacji przeglądu. + ## Kwestie prawne Przesyłając wkład, zgadzasz się, że Twoje wkłady będą licencjonowane na podstawie licencji Apache 2.0, zgodnie z licencją Zoo Code. diff --git a/locales/pt-BR/CONTRIBUTING.md b/locales/pt-BR/CONTRIBUTING.md index 0634261dc6..29cf29a2ad 100644 --- a/locales/pt-BR/CONTRIBUTING.md +++ b/locales/pt-BR/CONTRIBUTING.md @@ -20,6 +20,8 @@ O Zoo Code é um projeto impulsionado pela comunidade, e valorizamos profundamen - [Antes de contribuir](#antes-de-contribuir) - [Encontrando e planejando sua contribuição](#encontrando-e-planejando-sua-contribuição) - [Processo de desenvolvimento e envio](#processo-de-desenvolvimento-e-envio) +- [Expectativas de Pull Request](#expectativas-de-pull-request) +- [Contribuições assistidas por IA](#contribuições-assistidas-por-ia) - [Legal](#legal) ## Antes de contribuir @@ -136,6 +138,32 @@ pnpm install - **Revisão aprofundada semanal:** avaliação abrangente. - **Itere prontamente** com base no feedback. +### Expectativas de Pull Request + +As Pull Requests devem ser revisáveis, testadas e manuteníveis. Antes de abrir uma PR, certifique-se de que: + +- A mudança é limitada a um issue, bug ou melhoria específica. +- Você pode explicar o que a mudança faz e por que está correta. +- Você testou a mudança localmente onde for prático. +- Você está disposto a responder ao feedback da revisão e fazer alterações de acompanhamento razoáveis. +- A PR não requer que os mantenedores reescrevam, redesenhem ou assumam substancialmente a propriedade da implementação antes de poder ser mesclada. + +Os mantenedores podem fechar PRs que estejam incompletas, muito amplas, inativas, não alinhadas com a direção do projeto ou que criem uma carga desproporcionada de revisão ou manutenção. Fechar uma PR não é um julgamento sobre o contribuidor; significa que a mudança não é mesclável em sua forma atual. + +### Contribuições assistidas por IA + +O uso de ferramentas de IA é permitido, mas os contribuidores permanecem totalmente responsáveis por suas submissões. + +Se você usar ferramentas de IA para ajudar a criar uma PR, você deve: + +- Revisar e entender cada mudança significativa. +- Ser capaz de explicar a implementação e as compensações em suas próprias palavras. +- Testar a mudança você mesmo onde for prático. +- Verificar se o código gerado é correto, necessário e compatível com a licença do projeto. +- Divulgar a assistência significativa de IA na descrição da PR quando ela tiver contribuído materialmente para o código, testes ou design. + +Por favor, não envie mudanças geradas por IA que você não entenda, não tenha testado ou que não possa manter durante a revisão. Os mantenedores podem fechar PRs que pareçam substancialmente assistidas por IA mas que careçam de verificação humana, justificativa clara ou acompanhamento da revisão. + ## Legal Ao contribuir, você concorda que suas contribuições serão licenciadas sob a Licença Apache 2.0, consistente com o licenciamento do Zoo Code. diff --git a/locales/ru/CONTRIBUTING.md b/locales/ru/CONTRIBUTING.md index 39efe27122..4de78228c3 100644 --- a/locales/ru/CONTRIBUTING.md +++ b/locales/ru/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code — это проект, управляемый сообществом, - [Прежде чем вы начнете вносить свой вклад](#прежде-чем-вы-начнете-вносить-свой-вклад) - [Поиск и планирование вашего вклада](#поиск-и-планирование-вашего-вклада) - [Процесс разработки и подачи](#процесс-разработки-и-подачи) +- [Требования к запросам на слияние](#требования-к-запросам-на-слияние) +- [Вклады с использованием ИИ](#вклады-с-использованием-ии) - [Юридические вопросы](#юридические-вопросы) ## Прежде чем вы начнете вносить свой вклад @@ -136,6 +138,32 @@ pnpm install - **Еженедельный углубленный обзор:** всесторонняя оценка. - **Быстро итерируйте** на основе обратной связи. +### Требования к запросам на слияние + +Запросы на слияние должны быть проверяемыми, протестированными и удобными для сопровождения. Перед открытием PR убедитесь, что: + +- Изменение ограничено конкретной задачей, ошибкой или улучшением. +- Вы можете объяснить, что делает изменение и почему оно правильное. +- Вы протестировали изменение локально там, где это практически возможно. +- Вы готовы отвечать на отзывы по результатам проверки и вносить разумные последующие изменения. +- PR не требует от сопровождающих существенной переработки, перепроектирования или принятия ответственности за реализацию перед слиянием. + +Сопровождающие могут закрывать PR, которые являются неполными, слишком широкими, неактивными, не соответствующими направлению проекта или создающими непропорциональную нагрузку на проверку или сопровождение. Закрытие PR не является суждением о вкладчике; это означает, что изменение в его нынешней форме не готово к слиянию. + +### Вклады с использованием ИИ + +Использование инструментов ИИ разрешено, но вкладчики несут полную ответственность за свои материалы. + +Если вы используете инструменты ИИ для создания PR, вы должны: + +- Проверить и понять каждое существенное изменение. +- Уметь объяснить реализацию и компромиссы своими словами. +- Самостоятельно протестировать изменение там, где это практически возможно. +- Убедиться, что сгенерированный код правильный, необходимый и совместимый с лицензией проекта. +- Раскрыть существенную помощь ИИ в описании PR, когда она внесла материальный вклад в код, тесты или дизайн. + +Пожалуйста, не отправляйте изменения, сгенерированные ИИ, которые вы не понимаете, не тестировали или не можете поддерживать в ходе проверки. Сопровождающие могут закрывать PR, которые в значительной степени кажутся созданными с помощью ИИ, но лишены проверки человеком, четкого обоснования или последующей работы по проверке. + ## Юридические вопросы Внося свой вклад, вы соглашаетесь с тем, что ваши вклады будут лицензироваться по лицензии Apache 2.0, в соответствии с лицензированием Zoo Code. diff --git a/locales/tr/CONTRIBUTING.md b/locales/tr/CONTRIBUTING.md index 24ed20e988..1188256cc0 100644 --- a/locales/tr/CONTRIBUTING.md +++ b/locales/tr/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code topluluk tarafından yürütülen bir projedir ve her katkıyı derinde - [Katkıda Bulunmadan Önce](#katkıda-bulunmadan-önce) - [Katkınızı Bulma ve Planlama](#katkınızı-bulma-ve-planlama) - [Geliştirme ve Gönderme Süreci](#geliştirme-ve-gönderme-süreci) +- [Pull Request Beklentileri](#pull-request-beklentileri) +- [YZ Destekli Katkılar](#yz-destekli-katkılar) - [Yasal](#yasal) ## Katkıda Bulunmadan Önce @@ -138,6 +140,32 @@ pnpm install - **Haftalık Derinlemesine İnceleme:** Kapsamlı değerlendirme. - Geri bildirime göre **hızlı bir şekilde yineleyin**. +### Pull Request Beklentileri + +Pull Request'ler incelenebilir, test edilmiş ve sürdürülebilir olmalıdır. Bir PR açmadan önce şunları sağlayın: + +- Değişiklik belirli bir sorun, hata veya iyileştirmeyle sınırlıdır. +- Değişikliğin ne yaptığını ve neden doğru olduğunu açıklayabilirsiniz. +- Değişikliği mümkün olduğunda yerel olarak test ettiniz. +- İnceleme geri bildirimine yanıt vermeye ve makul takip değişiklikleri yapmaya isteklisiniz. +- PR, birleştirilmeden önce sürdürücülerin uygulamayı önemli ölçüde yeniden yazmasını, yeniden tasarlamasını veya sahiplenmesini gerektirmiyor. + +Sürdürücüler, eksik, çok geniş kapsamlı, hareketsiz, proje yönüyle uyumsuz olan veya orantısız inceleme ya da bakım yükü oluşturan PR'leri kapatabilir. Bir PR'yi kapatmak, katkıda bulunan hakkında bir yargı değildir; bu, değişikliğin mevcut biçimiyle birleştirilemeyeceği anlamına gelir. + +### YZ Destekli Katkılar + +YZ araçlarının kullanımına izin verilmektedir, ancak katkıda bulunanlar gönderimlerinden tamamen sorumlu kalmaya devam eder. + +Bir PR oluşturmak için YZ araçları kullanıyorsanız şunları yapmanız gerekir: + +- Her önemli değişikliği gözden geçirin ve anlayın. +- Uygulamayı ve değiş tokuşları kendi sözlerinizle açıklayabilin. +- Mümkün olduğunda değişikliği kendiniz test edin. +- Oluşturulan kodun doğru, gerekli ve proje lisansıyla uyumlu olduğunu doğrulayın. +- Koda, testlere veya tasarıma önemli ölçüde katkıda bulunduğunda PR açıklamasında önemli YZ yardımını açıklayın. + +Anlamadığınız, test etmediğiniz veya inceleme sürecinde sürdüremeyeceğiniz YZ tarafından oluşturulan değişiklikler göndermeyin. Sürdürücüler, büyük ölçüde YZ destekli görünen ancak insan doğrulaması, net gerekçe veya inceleme takibi olmayan PR'leri kapatabilir. + ## Yasal Katkıda bulunarak, katkılarınızın Zoo Code'un lisanslamasıyla tutarlı olan Apache 2.0 Lisansı altında lisanslanacağını kabul etmiş olursunuz. diff --git a/locales/vi/CONTRIBUTING.md b/locales/vi/CONTRIBUTING.md index ef1cca5e8d..d39eabc287 100644 --- a/locales/vi/CONTRIBUTING.md +++ b/locales/vi/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code là một dự án do cộng đồng điều khiển và chúng tôi v - [Trước khi bạn đóng góp](#trước-khi-bạn-đóng-góp) - [Tìm kiếm và lập kế hoạch đóng góp của bạn](#tìm-kiếm-và-lập-kế-hoạch-đóng-góp-của-bạn) - [Quy trình phát triển và gửi](#quy-trình-phát-triển-và-gửi) +- [Kỳ vọng về Yêu cầu kéo](#kỳ-vọng-về-yêu-cầu-kéo) +- [Đóng góp có sự hỗ trợ của AI](#đóng-góp-có-sự-hỗ-trợ-của-ai) - [Pháp lý](#pháp-lý) ## Trước khi bạn đóng góp @@ -136,6 +138,32 @@ pnpm install - **Xem xét sâu hàng tuần:** đánh giá toàn diện. - **Lặp lại nhanh chóng** dựa trên phản hồi. +### Kỳ vọng về Yêu cầu kéo + +Các Yêu cầu kéo phải có thể xem xét được, đã được kiểm tra và có thể bảo trì. Trước khi mở PR, hãy đảm bảo rằng: + +- Thay đổi được giới hạn trong một vấn đề, lỗi hoặc cải tiến cụ thể. +- Bạn có thể giải thích thay đổi làm gì và tại sao nó đúng. +- Bạn đã kiểm tra thay đổi cục bộ khi có thể thực hiện được. +- Bạn sẵn sàng phản hồi phản hồi xem xét và thực hiện các thay đổi tiếp theo hợp lý. +- PR không yêu cầu những người bảo trì viết lại, thiết kế lại hoặc tiếp quản đáng kể việc triển khai trước khi có thể hợp nhất. + +Những người bảo trì có thể đóng các PR không đầy đủ, quá rộng, không hoạt động, không phù hợp với hướng dự án hoặc tạo ra gánh nặng xem xét hoặc bảo trì không tương xứng. Đóng PR không phải là phán xét về người đóng góp; nó có nghĩa là thay đổi hiện không thể hợp nhất ở dạng hiện tại. + +### Đóng góp có sự hỗ trợ của AI + +Việc sử dụng các công cụ AI được phép, nhưng người đóng góp vẫn hoàn toàn chịu trách nhiệm về các bài nộp của họ. + +Nếu bạn sử dụng các công cụ AI để giúp tạo PR, bạn phải: + +- Xem xét và hiểu mọi thay đổi có ý nghĩa. +- Có thể giải thích việc triển khai và sự đánh đổi bằng lời của chính bạn. +- Tự kiểm tra thay đổi khi có thể thực hiện được. +- Xác minh rằng mã được tạo là chính xác, cần thiết và tương thích với giấy phép dự án. +- Tiết lộ sự hỗ trợ AI đáng kể trong mô tả PR khi nó đóng góp đáng kể vào mã, kiểm tra hoặc thiết kế. + +Vui lòng không gửi các thay đổi do AI tạo ra mà bạn không hiểu, chưa kiểm tra hoặc không thể duy trì trong quá trình xem xét. Những người bảo trì có thể đóng các PR có vẻ được hỗ trợ đáng kể bởi AI nhưng thiếu xác minh của con người, lý do rõ ràng hoặc theo dõi xem xét. + ## Pháp lý Bằng cách đóng góp, bạn đồng ý rằng những đóng góp của bạn sẽ được cấp phép theo Giấy phép Apache 2.0, phù hợp với việc cấp phép của Zoo Code. diff --git a/locales/zh-CN/CONTRIBUTING.md b/locales/zh-CN/CONTRIBUTING.md index 8a3c5cc516..0ec77116a5 100644 --- a/locales/zh-CN/CONTRIBUTING.md +++ b/locales/zh-CN/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code 是一个由社区驱动的项目，我们非常重视每一份贡献 - [在您贡献之前](#在您贡献之前) - [寻找和规划您的贡献](#寻找和规划您的贡献) - [开发和提交流程](#开发和提交流程) +- [拉取请求的期望](#拉取请求的期望) +- [AI辅助贡献](#ai辅助贡献) - [法律](#法律) ## 在您贡献之前 @@ -136,6 +138,32 @@ pnpm install - **每周深入审查：** 全面评估。 - **根据反馈及时迭代**。 +### 拉取请求的期望 + +拉取请求应当可审查、经过测试且可维护。在开启 PR 之前，请确保： + +- 变更仅限于特定的问题、错误或改进。 +- 您能够解释变更的内容以及为何正确。 +- 您已在可行的情况下在本地测试了变更。 +- 您愿意响应审查反馈并进行合理的后续更改。 +- PR 无需维护人员在合并之前实质性地重写、重新设计或接管实现。 + +维护人员可以关闭不完整、范围过广、不活跃、与项目方向不符或产生不相称的审查或维护负担的 PR。关闭 PR 不是对贡献者的评判；这意味着该变更目前以其现有形式不可合并。 + +### AI辅助贡献 + +允许使用 AI 工具，但贡献者对其提交内容负全部责任。 + +如果您使用 AI 工具帮助创建 PR，您必须： + +- 审查并理解每一项有意义的变更。 +- 能够用自己的话解释实现方式和权衡取舍。 +- 在可行的情况下自行测试变更。 +- 验证生成的代码是否正确、必要且与项目许可证兼容。 +- 当 AI 对代码、测试或设计有实质性贡献时，在 PR 描述中披露重要的 AI 辅助。 + +请勿提交您不理解、未经测试或无法在审查过程中维护的 AI 生成变更。维护人员可能会关闭看似主要由 AI 辅助但缺乏人工验证、明确理由或审查跟进的 PR。 + ## 法律 通过贡献，您同意您的贡献将根据 Apache 2.0 许可证进行许可，这与 Zoo Code 的许可一致。 diff --git a/locales/zh-TW/CONTRIBUTING.md b/locales/zh-TW/CONTRIBUTING.md index 945fbe8937..c4cfa76c24 100644 --- a/locales/zh-TW/CONTRIBUTING.md +++ b/locales/zh-TW/CONTRIBUTING.md @@ -20,6 +20,8 @@ Zoo Code 是一個由社群驅動的專案，我們非常重視每一份貢獻 - [在您貢獻之前](#在您貢獻之前) - [尋找和規劃您的貢獻](#尋找和規劃您的貢獻) - [開發和提交流程](#開發和提交流程) +- [Pull Request 的期望](#pull-request-的期望) +- [AI 輔助貢獻](#ai-輔助貢獻) - [法律](#法律) ## 在您貢獻之前 @@ -136,6 +138,32 @@ pnpm install - **每週深入審查：** 全面評估。 - **根據回饋及時迭代**。 +### Pull Request 的期望 + +Pull Request 應當可審查、經過測試且可維護。在開啟 PR 之前，請確保： + +- 變更僅限於特定的問題、錯誤或改進。 +- 您能夠解釋變更的內容以及為何正確。 +- 您已在可行的情況下在本地測試了變更。 +- 您願意回應審查意見並進行合理的後續更改。 +- PR 無需維護者在合併之前實質性地重寫、重新設計或接管實作。 + +維護者可以關閉不完整、範圍過廣、不活躍、與專案方向不符或產生不相稱的審查或維護負擔的 PR。關閉 PR 不是對貢獻者的評判；這意味著該變更目前以其現有形式不可合併。 + +### AI 輔助貢獻 + +允許使用 AI 工具，但貢獻者對其提交內容負全部責任。 + +如果您使用 AI 工具協助建立 PR，您必須： + +- 審查並理解每一項有意義的變更。 +- 能夠用自己的話解釋實作方式和取捨。 +- 在可行的情況下自行測試變更。 +- 驗證生成的程式碼是否正確、必要且與專案授權條款相容。 +- 當 AI 對程式碼、測試或設計有實質性貢獻時，在 PR 說明中揭露重要的 AI 輔助情況。 + +請勿提交您不理解、未經測試或無法在審查過程中維護的 AI 生成變更。維護者可能會關閉看似主要由 AI 輔助但缺乏人工驗證、明確理由或審查跟進的 PR。 + ## 法律資訊 透過貢獻，您同意您的貢獻將根據 Apache 2.0 授權條款進行授權，這與 Zoo Code 的授權一致。 From ae1fba715c12c387b62e5ce679a16507dbad7d42 Mon Sep 17 00:00:00 2001 From: Elliott de Launay Date: Wed, 10 Jun 2026 22:36:23 +0000 Subject: [PATCH 2/2] docs(CONTRIBUTO): phrasing --- CONTRIBUTING.md | 12 ++++++------ locales/ca/CONTRIBUTING.md | 8 ++++---- locales/de/CONTRIBUTING.md | 8 ++++---- locales/es/CONTRIBUTING.md | 8 ++++---- locales/fr/CONTRIBUTING.md | 8 ++++---- locales/hi/CONTRIBUTING.md | 8 ++++---- locales/id/CONTRIBUTING.md | 8 ++++---- locales/it/CONTRIBUTING.md | 10 +++++----- locales/ja/CONTRIBUTING.md | 8 ++++---- locales/ko/CONTRIBUTING.md | 8 ++++---- locales/nl/CONTRIBUTING.md | 8 ++++---- locales/pl/CONTRIBUTING.md | 8 ++++---- locales/pt-BR/CONTRIBUTING.md | 8 ++++---- locales/ru/CONTRIBUTING.md | 8 ++++---- locales/tr/CONTRIBUTING.md | 8 ++++---- locales/vi/CONTRIBUTING.md | 8 ++++---- locales/zh-CN/CONTRIBUTING.md | 8 ++++---- locales/zh-TW/CONTRIBUTING.md | 8 ++++---- 18 files changed, 75 insertions(+), 75 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e47cee2311..d65a7a3535 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -20,8 +20,8 @@ Zoo Code is a community-driven project, and we deeply value every contribution. - [Before You Contribute](#before-you-contribute) - [Finding & Planning Your Contribution](#finding--planning-your-contribution) - [Development & Submission Process](#development--submission-process) -- [Pull Request Expectations](#pull-request-expectations) -- [AI-Assisted Contributions](#ai-assisted-contributions) + - [Pull Request Expectations](#pull-request-expectations) + - [AI-Assisted Contributions](#ai-assisted-contributions) - [Legal](#legal) ## Before You Contribute @@ -148,7 +148,7 @@ Pull requests should be reviewable, tested, and maintainable. Before opening a P - You are willing to respond to review feedback and make reasonable follow-up changes. - The PR does not require maintainers to substantially rewrite, redesign, or take ownership of the implementation before it can be merged. -Maintainers may close PRs that are incomplete, too broad, inactive, not aligned with the project direction, or that create disproportionate review or maintenance burden. Closing a PR is not a judgment on the contributor; it means the change is not currently mergeable in its present form. +Maintainers may close PRs that are incomplete, too broad, inactive, not aligned with the project direction, or that create disproportionate review or maintenance burden. Closing a PR is not a judgment on the contributor; it is a maintainer decision that the change cannot be accepted in its present form. ### AI-Assisted Contributions @@ -158,11 +158,11 @@ If you use AI tools to help create a PR, you must: - Review and understand every meaningful change. - Be able to explain the implementation and tradeoffs in your own words. -- Test the change yourself where practical. +- Test the change yourself. If testing is impractical for your environment, explain why in the PR description and describe how reviewers can verify the change instead. - Verify that generated code is correct, necessary, and compatible with the project license. -- Disclose meaningful AI assistance in the PR description when it materially contributed to the code, tests, or design. +- Consider disclosing AI assistance in the PR description when it materially shaped the code, tests, or design — this helps reviewers give better feedback. -Please do not submit AI-generated changes that you do not understand, have not tested, or cannot maintain through review. Maintainers may close PRs that appear to be substantially AI-assisted but lack human verification, clear rationale, or review follow-through. +Please do not submit AI-generated changes that you do not understand or cannot maintain through review. Maintainers may close PRs that appear substantially AI-assisted but lack human verification, clear rationale, or review follow-through. ## Legal diff --git a/locales/ca/CONTRIBUTING.md b/locales/ca/CONTRIBUTING.md index 475cf38132..e53af6e415 100644 --- a/locales/ca/CONTRIBUTING.md +++ b/locales/ca/CONTRIBUTING.md @@ -148,7 +148,7 @@ Les sol·licituds d'extracció han de ser revisables, provades i mantenibles. Ab - Esteu disposats a respondre als comentaris de la revisió i fer canvis raonables de seguiment. - La PR no requereix que els mantenidors reescriguin, redissenyin o assumeixin la propietat substancial de la implementació abans de poder fusionar-la. -Els mantenidors poden tancar les PR que estiguin incompletes, siguin massa àmplies, inactives, no estiguin alineades amb la direcció del projecte o que creïn una càrrega desproporcionada de revisió o manteniment. Tancar una PR no és un judici sobre el col·laborador; significa que el canvi no és fusionable en la seva forma actual. +Els mantenidors poden tancar les PR que estiguin incompletes, siguin massa àmplies, inactives, no estiguin alineades amb la direcció del projecte o que creïn una càrrega desproporcionada de revisió o manteniment. Tancar una PR no és un judici sobre el col·laborador; és una decisió dels mantenidors que el canvi no pot ser acceptat en la seva forma actual. ### Contribucions amb assistència d'IA @@ -158,11 +158,11 @@ Si utiliseu eines d'IA per ajudar a crear una PR, heu de: - Revisar i comprendre cada canvi significatiu. - Ser capaços d'explicar la implementació i els compromisos amb les vostres pròpies paraules. -- Provar el canvi vosaltres mateixos on sigui pràctic. +- Provar el canvi vosaltres mateixos. Si les proves no són pràctiques en el vostre entorn, expliqueu per què a la descripció de la PR i descriviu com els revisors poden verificar el canvi. - Verificar que el codi generat és correcte, necessari i compatible amb la llicència del projecte. -- Revelar l'assistència significativa de la IA a la descripció de la PR quan hagi contribuït materialment al codi, les proves o el disseny. +- Considereu revelar l'assistència d'IA a la descripció de la PR quan hagi influït materialment en el codi, les proves o el disseny — això ajuda els revisors a donar millors comentaris. -Si us plau, no envieu canvis generats per IA que no enteneu, no heu provat o no podeu mantenir durant la revisió. Els mantenidors poden tancar les PR que semblin substancialment assistides per IA però que manquin de verificació humana, raonament clar o seguiment de la revisió. +Si us plau, no envieu canvis generats per IA que no enteneu o que no podeu mantenir durant la revisió. Els mantenidors poden tancar les PR que semblin substancialment assistides per IA però que manquin de verificació humana, raonament clar o seguiment de la revisió. ## Legal diff --git a/locales/de/CONTRIBUTING.md b/locales/de/CONTRIBUTING.md index e91422f933..58f1e99e49 100644 --- a/locales/de/CONTRIBUTING.md +++ b/locales/de/CONTRIBUTING.md @@ -148,7 +148,7 @@ Pull Requests müssen überprüfbar, getestet und wartbar sein. Stelle vor dem - Du bereit bist, auf Review-Feedback zu antworten und angemessene Folgeanpassungen vorzunehmen. - Der PR nicht erfordert, dass Betreuer die Implementierung vor dem Mergen wesentlich umschreiben, neu gestalten oder übernehmen. -Betreuer können PRs schließen, die unvollständig, zu umfangreich, inaktiv, nicht mit der Projektrichtung abgestimmt sind oder einen unverhältnismäßigen Review- oder Wartungsaufwand verursachen. Das Schließen eines PRs ist kein Urteil über den Beitragenden; es bedeutet, dass die Änderung in ihrer aktuellen Form nicht mergebar ist. +Betreuer können PRs schließen, die unvollständig, zu umfangreich, inaktiv, nicht mit der Projektrichtung abgestimmt sind oder einen unverhältnismäßigen Review- oder Wartungsaufwand verursachen. Das Schließen eines PRs ist kein Urteil über den Beitragenden; es ist eine Entscheidung der Betreuer, dass die Änderung in ihrer aktuellen Form nicht akzeptiert werden kann. ### KI-gestützte Beiträge @@ -158,11 +158,11 @@ Wenn du KI-Tools zur Erstellung eines PRs verwendest, musst du: - Jede wesentliche Änderung überprüfen und verstehen. - Die Implementierung und die Kompromisse in eigenen Worten erklären können. -- Die Änderung selbst testen, soweit praktisch möglich. +- Die Änderung selbst testen. Wenn Tests in deiner Umgebung nicht praktisch durchführbar sind, erkläre warum in der PR-Beschreibung und beschreibe, wie Reviewer die Änderung stattdessen überprüfen können. - Sicherstellen, dass der generierte Code korrekt, notwendig und mit der Projektlizenz kompatibel ist. -- Wesentliche KI-Unterstützung in der PR-Beschreibung offenlegen, wenn sie maßgeblich zum Code, den Tests oder dem Design beigetragen hat. +- Erwäge, KI-Unterstützung in der PR-Beschreibung offenzulegen, wenn sie den Code, die Tests oder das Design wesentlich beeinflusst hat — das hilft Reviewern, besseres Feedback zu geben. -Bitte reiche keine KI-generierten Änderungen ein, die du nicht verstehst, nicht getestet hast oder die du nicht durch den Review-Prozess pflegen kannst. Betreuer können PRs schließen, die überwiegend KI-gestützt erscheinen, aber keine menschliche Überprüfung, klare Begründung oder Review-Nachverfolgung aufweisen. +Bitte reiche keine KI-generierten Änderungen ein, die du nicht verstehst oder die du nicht durch den Review-Prozess pflegen kannst. Betreuer können PRs schließen, die überwiegend KI-gestützt erscheinen, aber keine menschliche Überprüfung, klare Begründung oder Review-Nachverfolgung aufweisen. ## Rechtliches diff --git a/locales/es/CONTRIBUTING.md b/locales/es/CONTRIBUTING.md index e1d1b2cca5..aa32621571 100644 --- a/locales/es/CONTRIBUTING.md +++ b/locales/es/CONTRIBUTING.md @@ -148,7 +148,7 @@ Las solicitudes de extracción deben ser revisables, probadas y mantenibles. Ant - Está dispuesto a responder a los comentarios de revisión y realizar cambios de seguimiento razonables. - La PR no requiere que los mantenedores reescriban, rediseñen o asuman sustancialmente la propiedad de la implementación antes de poder fusionarla. -Los mantenedores pueden cerrar PRs que estén incompletas, sean demasiado amplias, inactivas, no estén alineadas con la dirección del proyecto o que creen una carga desproporcionada de revisión o mantenimiento. Cerrar una PR no es un juicio sobre el colaborador; significa que el cambio no es fusionable en su forma actual. +Los mantenedores pueden cerrar PRs que estén incompletas, sean demasiado amplias, inactivas, no estén alineadas con la dirección del proyecto o que creen una carga desproporcionada de revisión o mantenimiento. Cerrar una PR no es un juicio sobre el colaborador; es una decisión de los mantenedores de que el cambio no puede aceptarse en su forma actual. ### Contribuciones asistidas por IA @@ -158,11 +158,11 @@ Si utiliza herramientas de IA para ayudar a crear una PR, debe: - Revisar y comprender cada cambio significativo. - Ser capaz de explicar la implementación y las compensaciones con sus propias palabras. -- Probar el cambio usted mismo donde sea práctico. +- Probar el cambio usted mismo. Si las pruebas no son prácticas en su entorno, explique por qué en la descripción de la PR y describa cómo los revisores pueden verificar el cambio. - Verificar que el código generado sea correcto, necesario y compatible con la licencia del proyecto. -- Revelar la asistencia significativa de la IA en la descripción de la PR cuando haya contribuido materialmente al código, las pruebas o el diseño. +- Considere revelar la asistencia de IA en la descripción de la PR cuando haya influido materialmente en el código, las pruebas o el diseño — esto ayuda a los revisores a dar mejor retroalimentación. -Por favor, no envíe cambios generados por IA que no entienda, no haya probado o que no pueda mantener durante la revisión. Los mantenedores pueden cerrar las PRs que parezcan sustancialmente asistidas por IA pero que carezcan de verificación humana, justificación clara o seguimiento de la revisión. +Por favor, no envíe cambios generados por IA que no entienda o que no pueda mantener durante la revisión. Los mantenedores pueden cerrar las PRs que parezcan sustancialmente asistidas por IA pero que carezcan de verificación humana, justificación clara o seguimiento de la revisión. ## Legal diff --git a/locales/fr/CONTRIBUTING.md b/locales/fr/CONTRIBUTING.md index d3712d96e5..40b050b01f 100644 --- a/locales/fr/CONTRIBUTING.md +++ b/locales/fr/CONTRIBUTING.md @@ -148,7 +148,7 @@ Les Pull Requests doivent être révisables, testées et maintenables. Avant d'o - Vous êtes prêt à répondre aux retours de la révision et à effectuer des modifications de suivi raisonnables. - La PR ne nécessite pas que les mainteneurs réécrivent, reconçoivent ou prennent en charge de manière substantielle l'implémentation avant de pouvoir la fusionner. -Les mainteneurs peuvent fermer les PRs qui sont incomplètes, trop larges, inactives, non alignées avec la direction du projet ou qui créent une charge de révision ou de maintenance disproportionnée. Fermer une PR n'est pas un jugement sur le contributeur ; cela signifie que le changement n'est pas fusionnable dans sa forme actuelle. +Les mainteneurs peuvent fermer les PRs qui sont incomplètes, trop larges, inactives, non alignées avec la direction du projet ou qui créent une charge de révision ou de maintenance disproportionnée. Fermer une PR n'est pas un jugement sur le contributeur ; c'est une décision des mainteneurs que le changement ne peut pas être accepté dans sa forme actuelle. ### Contributions assistées par IA @@ -158,11 +158,11 @@ Si vous utilisez des outils d'IA pour aider à créer une PR, vous devez : - Réviser et comprendre chaque modification significative. - Être capable d'expliquer l'implémentation et les compromis avec vos propres mots. -- Tester vous-même le changement dans la mesure du possible. +- Tester vous-même le changement. Si les tests ne sont pas pratiques dans votre environnement, expliquez pourquoi dans la description de la PR et décrivez comment les réviseurs peuvent vérifier le changement. - Vérifier que le code généré est correct, nécessaire et compatible avec la licence du projet. -- Divulguer l'assistance significative de l'IA dans la description de la PR lorsqu'elle a contribué de manière substantielle au code, aux tests ou à la conception. +- Envisagez de divulguer l'assistance de l'IA dans la description de la PR lorsqu'elle a substantiellement façonné le code, les tests ou la conception — cela aide les réviseurs à donner de meilleurs retours. -Veuillez ne pas soumettre de modifications générées par IA que vous ne comprenez pas, que vous n'avez pas testées ou que vous ne pouvez pas maintenir lors de la révision. Les mainteneurs peuvent fermer les PRs qui semblent substantiellement assistées par IA mais qui manquent de vérification humaine, de justification claire ou de suivi de la révision. +Veuillez ne pas soumettre de modifications générées par IA que vous ne comprenez pas ou que vous ne pouvez pas maintenir lors de la révision. Les mainteneurs peuvent fermer les PRs qui semblent substantiellement assistées par IA mais qui manquent de vérification humaine, de justification claire ou de suivi de la révision. ## Légal diff --git a/locales/hi/CONTRIBUTING.md b/locales/hi/CONTRIBUTING.md index 14071fab87..ed12eeb4a0 100644 --- a/locales/hi/CONTRIBUTING.md +++ b/locales/hi/CONTRIBUTING.md @@ -148,7 +148,7 @@ pnpm install - आप समीक्षा प्रतिक्रिया का जवाब देने और उचित अनुवर्ती परिवर्तन करने के लिए तैयार हैं। - पीआर के लिए अनुरक्षकों को विलय से पहले कार्यान्वयन को मूल रूप से फिर से लिखने, पुनर्डिज़ाइन करने या स्वामित्व लेने की आवश्यकता नहीं है। -अनुरक्षक ऐसी पीआर को बंद कर सकते हैं जो अधूरी, बहुत व्यापक, निष्क्रिय, परियोजना की दिशा के अनुरूप नहीं, या जो असंगत समीक्षा या रखरखाव बोझ पैदा करती हों। पीआर को बंद करना योगदानकर्ता पर कोई निर्णय नहीं है; इसका अर्थ है कि परिवर्तन अपने वर्तमान स्वरूप में विलय योग्य नहीं है। +अनुरक्षक ऐसी पीआर को बंद कर सकते हैं जो अधूरी, बहुत व्यापक, निष्क्रिय, परियोजना की दिशा के अनुरूप नहीं, या जो असंगत समीक्षा या रखरखाव बोझ पैदा करती हों। पीआर को बंद करना योगदानकर्ता पर कोई निर्णय नहीं है; यह अनुरक्षकों का निर्णय है कि परिवर्तन अपने वर्तमान स्वरूप में स्वीकार नहीं किया जा सकता। ### एआई-सहायता प्राप्त योगदान @@ -158,11 +158,11 @@ pnpm install - हर महत्वपूर्ण परिवर्तन की समीक्षा करनी और समझनी होगी। - अपने शब्दों में कार्यान्वयन और ट्रेडऑफ़ समझाने में सक्षम होना होगा। -- जहाँ व्यावहारिक हो, परिवर्तन को स्वयं परीक्षित करना होगा। +- परिवर्तन को स्वयं परीक्षित करना होगा। यदि आपके परिवेश में परीक्षण व्यावहारिक नहीं है, तो पीआर विवरण में कारण बताएं और वर्णन करें कि समीक्षक परिवर्तन को कैसे सत्यापित कर सकते हैं। - यह सत्यापित करना होगा कि उत्पन्न कोड सही, आवश्यक और परियोजना लाइसेंस के अनुकूल है। -- पीआर विवरण में महत्वपूर्ण एआई सहायता का खुलासा करना होगा जब इसने कोड, परीक्षण या डिज़ाइन में भौतिक रूप से योगदान दिया हो। +- पीआर विवरण में एआई सहायता का खुलासा करने पर विचार करें जब इसने कोड, परीक्षण या डिज़ाइन को महत्वपूर्ण रूप से आकार दिया हो — इससे समीक्षकों को बेहतर प्रतिक्रिया देने में मदद मिलती है। -कृपया ऐसे एआई-उत्पन्न परिवर्तन प्रस्तुत न करें जिन्हें आप नहीं समझते, परीक्षित नहीं किया है, या समीक्षा के दौरान बनाए नहीं रख सकते। अनुरक्षक ऐसी पीआर को बंद कर सकते हैं जो काफी हद तक एआई-सहायता प्राप्त प्रतीत होती हैं लेकिन मानवीय सत्यापन, स्पष्ट तर्क या समीक्षा अनुवर्ती का अभाव है। +कृपया ऐसे एआई-उत्पन्न परिवर्तन प्रस्तुत न करें जिन्हें आप नहीं समझते या समीक्षा के दौरान बनाए नहीं रख सकते। अनुरक्षक ऐसी पीआर को बंद कर सकते हैं जो काफी हद तक एआई-सहायता प्राप्त प्रतीत होती हैं लेकिन मानवीय सत्यापन, स्पष्ट तर्क या समीक्षा अनुवर्ती का अभाव है। ## कानूनी diff --git a/locales/id/CONTRIBUTING.md b/locales/id/CONTRIBUTING.md index ec0cafb075..099e547285 100644 --- a/locales/id/CONTRIBUTING.md +++ b/locales/id/CONTRIBUTING.md @@ -148,7 +148,7 @@ Pull Request harus dapat ditinjau, diuji, dan dapat dipelihara. Sebelum membuka - Anda bersedia merespons umpan balik ulasan dan melakukan perubahan tindak lanjut yang wajar. - PR tidak mengharuskan pengelola untuk menulis ulang, mendesain ulang, atau mengambil alih kepemilikan implementasi secara substansial sebelum dapat digabungkan. -Pengelola dapat menutup PR yang tidak lengkap, terlalu luas, tidak aktif, tidak selaras dengan arah proyek, atau yang menciptakan beban ulasan atau pemeliharaan yang tidak proporsional. Menutup PR bukan merupakan penilaian terhadap kontributor; artinya perubahan tersebut tidak dapat digabungkan dalam bentuknya saat ini. +Pengelola dapat menutup PR yang tidak lengkap, terlalu luas, tidak aktif, tidak selaras dengan arah proyek, atau yang menciptakan beban ulasan atau pemeliharaan yang tidak proporsional. Menutup PR bukan merupakan penilaian terhadap kontributor; itu adalah keputusan pengelola bahwa perubahan tersebut tidak dapat diterima dalam bentuknya saat ini. ### Kontribusi Berbantuan AI @@ -158,11 +158,11 @@ Jika Anda menggunakan alat AI untuk membantu membuat PR, Anda harus: - Meninjau dan memahami setiap perubahan yang berarti. - Mampu menjelaskan implementasi dan pertukaran dengan kata-kata Anda sendiri. -- Menguji perubahan sendiri jika memungkinkan. +- Menguji perubahan sendiri. Jika pengujian tidak praktis di lingkungan Anda, jelaskan alasannya dalam deskripsi PR dan uraikan bagaimana peninjau dapat memverifikasi perubahan tersebut. - Memverifikasi bahwa kode yang dihasilkan benar, diperlukan, dan kompatibel dengan lisensi proyek. -- Mengungkapkan bantuan AI yang signifikan dalam deskripsi PR ketika berkontribusi secara material pada kode, pengujian, atau desain. +- Pertimbangkan untuk mengungkapkan bantuan AI dalam deskripsi PR ketika hal itu secara material membentuk kode, pengujian, atau desain — ini membantu peninjau memberikan umpan balik yang lebih baik. -Jangan mengirimkan perubahan yang dihasilkan AI yang tidak Anda pahami, belum Anda uji, atau tidak dapat Anda pertahankan melalui ulasan. Pengelola dapat menutup PR yang tampaknya sebagian besar dibantu AI tetapi tidak memiliki verifikasi manusia, alasan yang jelas, atau tindak lanjut ulasan. +Jangan mengirimkan perubahan yang dihasilkan AI yang tidak Anda pahami atau tidak dapat Anda pertahankan melalui ulasan. Pengelola dapat menutup PR yang tampaknya sebagian besar dibantu AI tetapi tidak memiliki verifikasi manusia, alasan yang jelas, atau tindak lanjut ulasan. ## Hukum diff --git a/locales/it/CONTRIBUTING.md b/locales/it/CONTRIBUTING.md index 5cb0e6f0e9..fc0927715a 100644 --- a/locales/it/CONTRIBUTING.md +++ b/locales/it/CONTRIBUTING.md @@ -148,21 +148,21 @@ Le Pull Request devono essere revisionabili, testate e manutenibili. Prima di ap - Tu sia disposto a rispondere al feedback della revisione e ad apportare ragionevoli modifiche di follow-up. - La PR non richieda ai manutentori di riscrivere, riprogettare o assumere sostanzialmente la proprietà dell'implementazione prima di poter essere unita. -I manutentori possono chiudere le PR che sono incomplete, troppo ampie, inattive, non allineate con la direzione del progetto o che creano un onere di revisione o manutenzione sproporzionato. La chiusura di una PR non è un giudizio sul contributore; significa che la modifica non è attualmente unibile nella sua forma attuale. +I manutentori possono chiudere le PR che sono incomplete, troppo ampie, inattive, non allineate con la direzione del progetto o che creano un onere di revisione o manutenzione sproporzionato. La chiusura di una PR non è un giudizio sul contributore; è una decisione dei manutentori che la modifica non può essere accettata nella sua forma attuale. ### Contributi assistiti da IA -L'uso di strumenti di IA è consentito, ma i contributori rimangono completamente responsabili delle loro submissions. +L'uso di strumenti di IA è consentito, ma i contributori rimangono completamente responsabili delle loro contribuzioni. Se utilizzi strumenti di IA per aiutare a creare una PR, devi: - Revisionare e comprendere ogni modifica significativa. - Essere in grado di spiegare l'implementazione e i compromessi con parole tue. -- Testare tu stesso la modifica dove pratico. +- Testare tu stesso la modifica. Se i test non sono praticamente fattibili nel tuo ambiente, spiega il motivo nella descrizione della PR e descrivi come i revisori possono verificare la modifica. - Verificare che il codice generato sia corretto, necessario e compatibile con la licenza del progetto. -- Divulgare l'assistenza significativa dell'IA nella descrizione della PR quando ha contribuito materialmente al codice, ai test o al design. +- Valuta di divulgare l'assistenza dell'IA nella descrizione della PR quando ha influenzato sostanzialmente il codice, i test o il design — questo aiuta i revisori a fornire un feedback migliore. -Si prega di non inviare modifiche generate dall'IA che non si comprendono, non si sono testate o che non si possono mantenere durante la revisione. I manutentori possono chiudere le PR che sembrano sostanzialmente assistite dall'IA ma prive di verifica umana, motivazione chiara o follow-through della revisione. +Si prega di non inviare modifiche generate dall'IA che non si comprendono o che non si possono mantenere durante la revisione. I manutentori possono chiudere le PR che sembrano sostanzialmente assistite dall'IA ma prive di verifica umana, motivazione chiara o adeguato seguito nella revisione. ## Legale diff --git a/locales/ja/CONTRIBUTING.md b/locales/ja/CONTRIBUTING.md index 7eb30303e6..0374af2efc 100644 --- a/locales/ja/CONTRIBUTING.md +++ b/locales/ja/CONTRIBUTING.md @@ -148,7 +148,7 @@ pnpm install - レビューフィードバックに応答し、合理的なフォローアップ変更を行う意思がある。 - PRをマージする前に、メンテナーが実装を大幅に書き直したり、再設計したり、所有権を取得したりする必要がない。 -メンテナーは、不完全なPR、範囲が広すぎるPR、非活性なPR、プロジェクトの方向性に沿っていないPR、または不釣り合いなレビューや保守の負担を生じさせるPRを閉じることができます。PRを閉じることはコントリビューターへの判断ではありません。それは変更が現在の形ではマージできないことを意味します。 +メンテナーは、不完全なPR、範囲が広すぎるPR、非活性なPR、プロジェクトの方向性に沿っていないPR、または不釣り合いなレビューや保守の負担を生じさせるPRを閉じることができます。PRを閉じることはコントリビューターへの判断ではありません。それは変更が現在の形では受け入れられないというメンテナーの判断です。 ### AIを利用した貢献 @@ -158,11 +158,11 @@ PRの作成にAIツールを使用する場合は、以下が必要です。 - すべての重要な変更をレビューして理解する。 - 実装とトレードオフを自分の言葉で説明できる。 -- 可能な限り自分で変更をテストする。 +- 自分で変更をテストする。環境でテストが実行できない場合は、PRの説明でその理由を説明し、レビュアーが変更を検証できる方法を記述する。 - 生成されたコードが正確で、必要であり、プロジェクトのライセンスと互換性があることを確認する。 -- コード、テスト、または設計に実質的に貢献した場合は、PRの説明でAIの重要な支援を開示する。 +- AIがコード、テスト、または設計を大きく形作った場合は、PRの説明でAI支援を開示することを検討する — これによりレビュアーがより良いフィードバックを提供できる。 -理解していない、テストしていない、またはレビューを通じて維持できないAI生成の変更を提出しないでください。メンテナーは、実質的にAI支援と思われるが、人間による検証、明確な根拠、またはレビューのフォロースルーが欠如しているPRを閉じることができます。 +理解していない、またはレビューを通じて維持できないAI生成の変更を提出しないでください。メンテナーは、実質的にAI支援と思われるが、人間による検証、明確な根拠、またはレビューのフォロースルーが欠如しているPRを閉じることができます。 ## 法務 diff --git a/locales/ko/CONTRIBUTING.md b/locales/ko/CONTRIBUTING.md index 22fd425fc9..2dc3f8c6ec 100644 --- a/locales/ko/CONTRIBUTING.md +++ b/locales/ko/CONTRIBUTING.md @@ -148,7 +148,7 @@ pnpm install - 검토 피드백에 응답하고 합리적인 후속 변경 사항을 만들 의향이 있습니다. - PR을 병합하기 전에 유지 관리자가 구현을 실질적으로 재작성, 재설계하거나 소유권을 가져갈 필요가 없습니다. -유지 관리자는 불완전하거나, 너무 광범위하거나, 비활성이거나, 프로젝트 방향에 맞지 않거나, 불균형한 검토 또는 유지 관리 부담을 초래하는 PR을 닫을 수 있습니다. PR을 닫는 것은 기여자에 대한 판단이 아닙니다. 이는 변경 사항이 현재 형태로는 병합할 수 없음을 의미합니다. +유지 관리자는 불완전하거나, 너무 광범위하거나, 비활성이거나, 프로젝트 방향에 맞지 않거나, 불균형한 검토 또는 유지 관리 부담을 초래하는 PR을 닫을 수 있습니다. PR을 닫는 것은 기여자에 대한 판단이 아닙니다. 이는 변경 사항이 현재 형태로는 수락될 수 없다는 유지 관리자의 결정입니다. ### AI 보조 기여 @@ -158,11 +158,11 @@ PR 작성에 AI 도구를 사용하는 경우 다음을 해야 합니다. - 모든 중요한 변경 사항을 검토하고 이해합니다. - 자신의 말로 구현과 트레이드오프를 설명할 수 있어야 합니다. -- 가능한 경우 직접 변경 사항을 테스트합니다. +- 직접 변경 사항을 테스트합니다. 환경에서 테스트가 실용적이지 않은 경우, PR 설명에서 이유를 설명하고 검토자가 변경 사항을 확인할 수 있는 방법을 기술합니다. - 생성된 코드가 올바르고, 필요하며, 프로젝트 라이선스와 호환되는지 확인합니다. -- 코드, 테스트 또는 설계에 실질적으로 기여한 경우 PR 설명에서 AI의 중요한 지원을 공개합니다. +- AI가 코드, 테스트 또는 설계를 실질적으로 형성한 경우 PR 설명에서 AI 지원을 공개하는 것을 고려합니다 — 이렇게 하면 검토자가 더 나은 피드백을 제공하는 데 도움이 됩니다. -이해하지 못하거나, 테스트하지 않았거나, 검토를 통해 유지 관리할 수 없는 AI 생성 변경 사항을 제출하지 마세요. 유지 관리자는 실질적으로 AI 보조로 보이지만 인간의 검증, 명확한 근거 또는 검토 후속 조치가 부족한 PR을 닫을 수 있습니다. +이해하지 못하거나 검토를 통해 유지 관리할 수 없는 AI 생성 변경 사항을 제출하지 마세요. 유지 관리자는 실질적으로 AI 보조로 보이지만 인간의 검증, 명확한 근거 또는 검토 후속 조치가 부족한 PR을 닫을 수 있습니다. ## 법률 diff --git a/locales/nl/CONTRIBUTING.md b/locales/nl/CONTRIBUTING.md index e67d8f33d6..8719405327 100644 --- a/locales/nl/CONTRIBUTING.md +++ b/locales/nl/CONTRIBUTING.md @@ -148,7 +148,7 @@ Pull Requests moeten beoordeelbaar, getest en onderhoudbaar zijn. Zorg er voor h - Je bereid bent om te reageren op reviewfeedback en redelijke vervolgwijzigingen aan te brengen. - De PR niet vereist dat onderhouders de implementatie wezenlijk herschrijven, herontwerpen of eigenaarschap overnemen voordat deze kan worden samengevoegd. -Onderhouders kunnen PR's sluiten die onvolledig, te breed, inactief, niet in lijn met de projectrichting zijn, of die een onevenredige review- of onderhoudslast creëren. Het sluiten van een PR is geen oordeel over de bijdrager; het betekent dat de wijziging momenteel niet samenvoegbaar is in zijn huidige vorm. +Onderhouders kunnen PR's sluiten die onvolledig, te breed, inactief, niet in lijn met de projectrichting zijn, of die een onevenredige review- of onderhoudslast creëren. Het sluiten van een PR is geen oordeel over de bijdrager; het is een beslissing van de onderhouders dat de wijziging niet kan worden geaccepteerd in zijn huidige vorm. ### Door AI ondersteunde bijdragen @@ -158,11 +158,11 @@ Als je AI-tools gebruikt om een PR te helpen maken, moet je: - Elke significante wijziging beoordelen en begrijpen. - De implementatie en afwegingen in eigen woorden kunnen uitleggen. -- De wijziging zelf testen waar praktisch. +- De wijziging zelf testen. Als testen niet praktisch is in jouw omgeving, leg dan in de PR-beschrijving uit waarom en beschrijf hoe reviewers de wijziging kunnen verifiëren. - Verifiëren dat de gegenereerde code correct, noodzakelijk en compatibel is met de projectlicentie. -- Significante AI-hulp in de PR-beschrijving vermelden wanneer dit materieel heeft bijgedragen aan de code, tests of het ontwerp. +- Overweeg AI-hulp te vermelden in de PR-beschrijving wanneer dit de code, tests of het ontwerp wezenlijk heeft beïnvloed — dit helpt reviewers beter feedback te geven. -Dien geen AI-gegenereerde wijzigingen in die je niet begrijpt, niet hebt getest of die je niet kunt onderhouden tijdens de review. Onderhouders kunnen PR's sluiten die overwegend AI-ondersteund lijken maar geen menselijke verificatie, duidelijke motivatie of review-opvolging hebben. +Dien geen AI-gegenereerde wijzigingen in die je niet begrijpt of die je niet kunt onderhouden tijdens de review. Onderhouders kunnen PR's sluiten die overwegend AI-ondersteund lijken maar geen menselijke verificatie, duidelijke motivatie of review-opvolging hebben. ## Juridisch diff --git a/locales/pl/CONTRIBUTING.md b/locales/pl/CONTRIBUTING.md index 7d758aa26f..05d4f60e8a 100644 --- a/locales/pl/CONTRIBUTING.md +++ b/locales/pl/CONTRIBUTING.md @@ -148,7 +148,7 @@ pnpm install - Jesteś gotowy do odpowiadania na opinie z przeglądu i wprowadzania rozsądnych zmian następczych. - PR nie wymaga od opiekunów zasadniczego przepisania, przeprojektowania ani przejęcia własności implementacji przed scaleniem. -Opiekunowie mogą zamykać PR, które są niekompletne, zbyt szerokie, nieaktywne, niezgodne z kierunkiem projektu lub tworzące nieproporcjonalne obciążenie przeglądem lub konserwacją. Zamknięcie PR nie jest oceną współtwórcy; oznacza, że zmiana nie jest obecnie możliwa do scalenia w jej obecnej postaci. +Opiekunowie mogą zamykać PR, które są niekompletne, zbyt szerokie, nieaktywne, niezgodne z kierunkiem projektu lub tworzące nieproporcjonalne obciążenie przeglądem lub konserwacją. Zamknięcie PR nie jest oceną współtwórcy; jest to decyzja opiekunów, że zmiana nie może zostać zaakceptowana w jej obecnej postaci. ### Wkłady wspomagane przez AI @@ -158,11 +158,11 @@ Jeśli używasz narzędzi AI do pomocy przy tworzeniu PR, musisz: - Przejrzeć i zrozumieć każdą istotną zmianę. - Być w stanie wyjaśnić implementację i kompromisy własnymi słowami. -- Samodzielnie przetestować zmianę tam, gdzie jest to praktyczne. +- Samodzielnie przetestować zmianę. Jeśli testy nie są praktyczne w Twoim środowisku, wyjaśnij dlaczego w opisie PR i opisz, jak recenzenci mogą zweryfikować zmianę. - Zweryfikować, że wygenerowany kod jest poprawny, konieczny i zgodny z licencją projektu. -- Ujawnić znaczącą pomoc AI w opisie PR, gdy w istotny sposób przyczyniła się do kodu, testów lub projektu. +- Rozważ ujawnienie pomocy AI w opisie PR, gdy istotnie wpłynęła na kod, testy lub projekt — pomaga to recenzentom udzielać lepszych opinii. -Prosimy o nieprzesyłanie zmian wygenerowanych przez AI, których nie rozumiesz, nie przetestowałeś lub których nie możesz utrzymać podczas przeglądu. Opiekunowie mogą zamykać PR, które wydają się w istotnym stopniu wspomagane przez AI, ale brakuje im weryfikacji człowieka, jasnego uzasadnienia lub kontynuacji przeglądu. +Prosimy o nieprzesyłanie zmian wygenerowanych przez AI, których nie rozumiesz lub których nie możesz utrzymać podczas przeglądu. Opiekunowie mogą zamykać PR, które wydają się w istotnym stopniu wspomagane przez AI, ale brakuje im weryfikacji człowieka, jasnego uzasadnienia lub kontynuacji przeglądu. ## Kwestie prawne diff --git a/locales/pt-BR/CONTRIBUTING.md b/locales/pt-BR/CONTRIBUTING.md index 29cf29a2ad..1ac2651165 100644 --- a/locales/pt-BR/CONTRIBUTING.md +++ b/locales/pt-BR/CONTRIBUTING.md @@ -148,7 +148,7 @@ As Pull Requests devem ser revisáveis, testadas e manuteníveis. Antes de abrir - Você está disposto a responder ao feedback da revisão e fazer alterações de acompanhamento razoáveis. - A PR não requer que os mantenedores reescrevam, redesenhem ou assumam substancialmente a propriedade da implementação antes de poder ser mesclada. -Os mantenedores podem fechar PRs que estejam incompletas, muito amplas, inativas, não alinhadas com a direção do projeto ou que criem uma carga desproporcionada de revisão ou manutenção. Fechar uma PR não é um julgamento sobre o contribuidor; significa que a mudança não é mesclável em sua forma atual. +Os mantenedores podem fechar PRs que estejam incompletas, muito amplas, inativas, não alinhadas com a direção do projeto ou que criem uma carga desproporcionada de revisão ou manutenção. Fechar uma PR não é um julgamento sobre o contribuidor; é uma decisão dos mantenedores de que a mudança não pode ser aceita em sua forma atual. ### Contribuições assistidas por IA @@ -158,11 +158,11 @@ Se você usar ferramentas de IA para ajudar a criar uma PR, você deve: - Revisar e entender cada mudança significativa. - Ser capaz de explicar a implementação e as compensações em suas próprias palavras. -- Testar a mudança você mesmo onde for prático. +- Testar a mudança você mesmo. Se os testes não forem práticos no seu ambiente, explique o motivo na descrição da PR e descreva como os revisores podem verificar a mudança. - Verificar se o código gerado é correto, necessário e compatível com a licença do projeto. -- Divulgar a assistência significativa de IA na descrição da PR quando ela tiver contribuído materialmente para o código, testes ou design. +- Considere divulgar a assistência de IA na descrição da PR quando ela tiver influenciado materialmente o código, testes ou design — isso ajuda os revisores a fornecer um feedback melhor. -Por favor, não envie mudanças geradas por IA que você não entenda, não tenha testado ou que não possa manter durante a revisão. Os mantenedores podem fechar PRs que pareçam substancialmente assistidas por IA mas que careçam de verificação humana, justificativa clara ou acompanhamento da revisão. +Por favor, não envie mudanças geradas por IA que você não entenda ou que não possa manter durante a revisão. Os mantenedores podem fechar PRs que pareçam substancialmente assistidas por IA mas que careçam de verificação humana, justificativa clara ou acompanhamento da revisão. ## Legal diff --git a/locales/ru/CONTRIBUTING.md b/locales/ru/CONTRIBUTING.md index 4de78228c3..aa38a39a60 100644 --- a/locales/ru/CONTRIBUTING.md +++ b/locales/ru/CONTRIBUTING.md @@ -148,7 +148,7 @@ pnpm install - Вы готовы отвечать на отзывы по результатам проверки и вносить разумные последующие изменения. - PR не требует от сопровождающих существенной переработки, перепроектирования или принятия ответственности за реализацию перед слиянием. -Сопровождающие могут закрывать PR, которые являются неполными, слишком широкими, неактивными, не соответствующими направлению проекта или создающими непропорциональную нагрузку на проверку или сопровождение. Закрытие PR не является суждением о вкладчике; это означает, что изменение в его нынешней форме не готово к слиянию. +Сопровождающие могут закрывать PR, которые являются неполными, слишком широкими, неактивными, не соответствующими направлению проекта или создающими непропорциональную нагрузку на проверку или сопровождение. Закрытие PR не является суждением о вкладчике; это решение сопровождающих о том, что изменение не может быть принято в его нынешней форме. ### Вклады с использованием ИИ @@ -158,11 +158,11 @@ pnpm install - Проверить и понять каждое существенное изменение. - Уметь объяснить реализацию и компромиссы своими словами. -- Самостоятельно протестировать изменение там, где это практически возможно. +- Самостоятельно протестировать изменение. Если тестирование непрактично в вашей среде, объясните причину в описании PR и опишите, как проверяющие могут проверить изменение. - Убедиться, что сгенерированный код правильный, необходимый и совместимый с лицензией проекта. -- Раскрыть существенную помощь ИИ в описании PR, когда она внесла материальный вклад в код, тесты или дизайн. +- Рассмотрите возможность раскрытия помощи ИИ в описании PR, когда она существенно повлияла на код, тесты или дизайн — это помогает проверяющим давать более качественную обратную связь. -Пожалуйста, не отправляйте изменения, сгенерированные ИИ, которые вы не понимаете, не тестировали или не можете поддерживать в ходе проверки. Сопровождающие могут закрывать PR, которые в значительной степени кажутся созданными с помощью ИИ, но лишены проверки человеком, четкого обоснования или последующей работы по проверке. +Пожалуйста, не отправляйте изменения, сгенерированные ИИ, которые вы не понимаете или не можете поддерживать в ходе проверки. Сопровождающие могут закрывать PR, которые в значительной степени кажутся созданными с помощью ИИ, но лишены проверки человеком, четкого обоснования или последующей работы по проверке. ## Юридические вопросы diff --git a/locales/tr/CONTRIBUTING.md b/locales/tr/CONTRIBUTING.md index 1188256cc0..c51ae4fb3e 100644 --- a/locales/tr/CONTRIBUTING.md +++ b/locales/tr/CONTRIBUTING.md @@ -150,7 +150,7 @@ Pull Request'ler incelenebilir, test edilmiş ve sürdürülebilir olmalıdır. - İnceleme geri bildirimine yanıt vermeye ve makul takip değişiklikleri yapmaya isteklisiniz. - PR, birleştirilmeden önce sürdürücülerin uygulamayı önemli ölçüde yeniden yazmasını, yeniden tasarlamasını veya sahiplenmesini gerektirmiyor. -Sürdürücüler, eksik, çok geniş kapsamlı, hareketsiz, proje yönüyle uyumsuz olan veya orantısız inceleme ya da bakım yükü oluşturan PR'leri kapatabilir. Bir PR'yi kapatmak, katkıda bulunan hakkında bir yargı değildir; bu, değişikliğin mevcut biçimiyle birleştirilemeyeceği anlamına gelir. +Sürdürücüler, eksik, çok geniş kapsamlı, hareketsiz, proje yönüyle uyumsuz olan veya orantısız inceleme ya da bakım yükü oluşturan PR'leri kapatabilir. Bir PR'yi kapatmak, katkıda bulunan hakkında bir yargı değildir; değişikliğin mevcut biçimiyle kabul edilemeyeceğine dair bir sürdürücü kararıdır. ### YZ Destekli Katkılar @@ -160,11 +160,11 @@ Bir PR oluşturmak için YZ araçları kullanıyorsanız şunları yapmanız ger - Her önemli değişikliği gözden geçirin ve anlayın. - Uygulamayı ve değiş tokuşları kendi sözlerinizle açıklayabilin. -- Mümkün olduğunda değişikliği kendiniz test edin. +- Değişikliği kendiniz test edin. Ortamınızda test yapmak pratik değilse, PR açıklamasında nedenini açıklayın ve gözlemcilerin değişikliği nasıl doğrulayabileceğini tarif edin. - Oluşturulan kodun doğru, gerekli ve proje lisansıyla uyumlu olduğunu doğrulayın. -- Koda, testlere veya tasarıma önemli ölçüde katkıda bulunduğunda PR açıklamasında önemli YZ yardımını açıklayın. +- YZ kodu, testleri veya tasarımı önemli ölçüde şekillendirdiyse PR açıklamasında YZ yardımını açıklamayı düşünün — bu, gözlemcilerin daha iyi geri bildirim vermesine yardımcı olur. -Anlamadığınız, test etmediğiniz veya inceleme sürecinde sürdüremeyeceğiniz YZ tarafından oluşturulan değişiklikler göndermeyin. Sürdürücüler, büyük ölçüde YZ destekli görünen ancak insan doğrulaması, net gerekçe veya inceleme takibi olmayan PR'leri kapatabilir. +Anlamadığınız veya inceleme sürecinde sürdüremeyeceğiniz YZ tarafından oluşturulan değişiklikler göndermeyin. Sürdürücüler, büyük ölçüde YZ destekli görünen ancak insan doğrulaması, net gerekçe veya inceleme takibi olmayan PR'leri kapatabilir. ## Yasal diff --git a/locales/vi/CONTRIBUTING.md b/locales/vi/CONTRIBUTING.md index d39eabc287..ea05ceca67 100644 --- a/locales/vi/CONTRIBUTING.md +++ b/locales/vi/CONTRIBUTING.md @@ -148,7 +148,7 @@ Các Yêu cầu kéo phải có thể xem xét được, đã được kiểm tr - Bạn sẵn sàng phản hồi phản hồi xem xét và thực hiện các thay đổi tiếp theo hợp lý. - PR không yêu cầu những người bảo trì viết lại, thiết kế lại hoặc tiếp quản đáng kể việc triển khai trước khi có thể hợp nhất. -Những người bảo trì có thể đóng các PR không đầy đủ, quá rộng, không hoạt động, không phù hợp với hướng dự án hoặc tạo ra gánh nặng xem xét hoặc bảo trì không tương xứng. Đóng PR không phải là phán xét về người đóng góp; nó có nghĩa là thay đổi hiện không thể hợp nhất ở dạng hiện tại. +Những người bảo trì có thể đóng các PR không đầy đủ, quá rộng, không hoạt động, không phù hợp với hướng dự án hoặc tạo ra gánh nặng xem xét hoặc bảo trì không tương xứng. Đóng PR không phải là phán xét về người đóng góp; đó là quyết định của người bảo trì rằng thay đổi không thể được chấp nhận ở dạng hiện tại. ### Đóng góp có sự hỗ trợ của AI @@ -158,11 +158,11 @@ Nếu bạn sử dụng các công cụ AI để giúp tạo PR, bạn phải: - Xem xét và hiểu mọi thay đổi có ý nghĩa. - Có thể giải thích việc triển khai và sự đánh đổi bằng lời của chính bạn. -- Tự kiểm tra thay đổi khi có thể thực hiện được. +- Tự kiểm tra thay đổi. Nếu kiểm tra không thực tế trong môi trường của bạn, hãy giải thích lý do trong mô tả PR và mô tả cách người xem xét có thể xác minh thay đổi. - Xác minh rằng mã được tạo là chính xác, cần thiết và tương thích với giấy phép dự án. -- Tiết lộ sự hỗ trợ AI đáng kể trong mô tả PR khi nó đóng góp đáng kể vào mã, kiểm tra hoặc thiết kế. +- Cân nhắc tiết lộ sự hỗ trợ AI trong mô tả PR khi nó đã định hình đáng kể mã, kiểm tra hoặc thiết kế — điều này giúp người xem xét đưa ra phản hồi tốt hơn. -Vui lòng không gửi các thay đổi do AI tạo ra mà bạn không hiểu, chưa kiểm tra hoặc không thể duy trì trong quá trình xem xét. Những người bảo trì có thể đóng các PR có vẻ được hỗ trợ đáng kể bởi AI nhưng thiếu xác minh của con người, lý do rõ ràng hoặc theo dõi xem xét. +Vui lòng không gửi các thay đổi do AI tạo ra mà bạn không hiểu hoặc không thể duy trì trong quá trình xem xét. Những người bảo trì có thể đóng các PR có vẻ được hỗ trợ đáng kể bởi AI nhưng thiếu xác minh của con người, lý do rõ ràng hoặc theo dõi xem xét. ## Pháp lý diff --git a/locales/zh-CN/CONTRIBUTING.md b/locales/zh-CN/CONTRIBUTING.md index 0ec77116a5..a10b8cd6cb 100644 --- a/locales/zh-CN/CONTRIBUTING.md +++ b/locales/zh-CN/CONTRIBUTING.md @@ -148,7 +148,7 @@ pnpm install - 您愿意响应审查反馈并进行合理的后续更改。 - PR 无需维护人员在合并之前实质性地重写、重新设计或接管实现。 -维护人员可以关闭不完整、范围过广、不活跃、与项目方向不符或产生不相称的审查或维护负担的 PR。关闭 PR 不是对贡献者的评判；这意味着该变更目前以其现有形式不可合并。 +维护人员可以关闭不完整、范围过广、不活跃、与项目方向不符或产生不相称的审查或维护负担的 PR。关闭 PR 不是对贡献者的评判；这是维护人员认为该变更以其现有形式无法被接受的决定。 ### AI辅助贡献 @@ -158,11 +158,11 @@ pnpm install - 审查并理解每一项有意义的变更。 - 能够用自己的话解释实现方式和权衡取舍。 -- 在可行的情况下自行测试变更。 +- 自行测试变更。如果在您的环境中测试不可行，请在 PR 描述中说明原因，并描述审查者如何验证该变更。 - 验证生成的代码是否正确、必要且与项目许可证兼容。 -- 当 AI 对代码、测试或设计有实质性贡献时，在 PR 描述中披露重要的 AI 辅助。 +- 当 AI 对代码、测试或设计有实质性影响时，建议在 PR 描述中披露 AI 辅助情况 — 这有助于审查者提供更好的反馈。 -请勿提交您不理解、未经测试或无法在审查过程中维护的 AI 生成变更。维护人员可能会关闭看似主要由 AI 辅助但缺乏人工验证、明确理由或审查跟进的 PR。 +请勿提交您不理解或无法在审查过程中维护的 AI 生成变更。维护人员可能会关闭看似主要由 AI 辅助但缺乏人工验证、明确理由或审查跟进的 PR。 ## 法律 diff --git a/locales/zh-TW/CONTRIBUTING.md b/locales/zh-TW/CONTRIBUTING.md index c4cfa76c24..950614d853 100644 --- a/locales/zh-TW/CONTRIBUTING.md +++ b/locales/zh-TW/CONTRIBUTING.md @@ -148,7 +148,7 @@ Pull Request 應當可審查、經過測試且可維護。在開啟 PR 之前， - 您願意回應審查意見並進行合理的後續更改。 - PR 無需維護者在合併之前實質性地重寫、重新設計或接管實作。 -維護者可以關閉不完整、範圍過廣、不活躍、與專案方向不符或產生不相稱的審查或維護負擔的 PR。關閉 PR 不是對貢獻者的評判；這意味著該變更目前以其現有形式不可合併。 +維護者可以關閉不完整、範圍過廣、不活躍、與專案方向不符或產生不相稱的審查或維護負擔的 PR。關閉 PR 不是對貢獻者的評判；這是維護者認為該變更以其現有形式無法被接受的決定。 ### AI 輔助貢獻 @@ -158,11 +158,11 @@ Pull Request 應當可審查、經過測試且可維護。在開啟 PR 之前， - 審查並理解每一項有意義的變更。 - 能夠用自己的話解釋實作方式和取捨。 -- 在可行的情況下自行測試變更。 +- 自行測試變更。如果在您的環境中測試不可行，請在 PR 說明中說明原因，並描述審查者如何驗證該變更。 - 驗證生成的程式碼是否正確、必要且與專案授權條款相容。 -- 當 AI 對程式碼、測試或設計有實質性貢獻時，在 PR 說明中揭露重要的 AI 輔助情況。 +- 當 AI 對程式碼、測試或設計有實質性影響時，建議在 PR 說明中揭露 AI 輔助情況 — 這有助於審查者提供更好的回饋。 -請勿提交您不理解、未經測試或無法在審查過程中維護的 AI 生成變更。維護者可能會關閉看似主要由 AI 輔助但缺乏人工驗證、明確理由或審查跟進的 PR。 +請勿提交您不理解或無法在審查過程中維護的 AI 生成變更。維護者可能會關閉看似主要由 AI 輔助但缺乏人工驗證、明確理由或審查跟進的 PR。 ## 法律資訊