Táimid buíoch i gcónaí as ranníocaíochtaí le cód Django. Go deimhin, socraítear tuairiscí fabhtanna le ranníocaíochtaí gaolmhara *i bhfad níos gasta ná iad siúd gan réiteach.
\nMá tá saincheist fíor-thábhachtach á shocrú agat, mar shampla focal a athrú sa dhoiciméadú, is é an bealach is fearr chun an paiste a sholáthar ná iarratais tarraingthe GitHub a úsáid gan ticéad Trac.
\nSee Ag obair le Git agus GitHub for more\ndetails on how to use pull requests.
\nI dtionscadal foinse oscailte leis na céadta ranníocóirí ar fud an domhain, tá sé tábhachtach an chumarsáid a bhainistiú go héifeachtach ionas nach ndúblaítear an obair agus gur féidir le rannpháirtithe a bheith chomh héifeachtach agus is féidir.
\nDá bhrí sin, is é ár mbeartas ná do rannpháirtithe ticéid a “éileamh” d'fhonn a chur in iúl d'fhorbróirí eile go bhfuil fabht nó gné áirithe á n-oibriú air.
\nMá aithníodh tú ranníocaíocht a theastaíonn uait a dhéanamh agus má tá tú in ann é a shocrú (mar a thomhaistear de réir do chumas códaithe, eolas ar inmheánacha Django agus infhaighteacht ama), éileamh é trí na céimeanna seo a leanúint:
\nLog in using your GitHub account or create an account in our ticket\nsystem. If you have an account but have forgotten your password, you can\nreset it using the password reset page.
If a ticket for this issue doesn't exist yet, create one in our\nticket tracker. Remember that proposals for new features should follow\nthe process for suggesting new features.
If a ticket for this issue already exists and has been accepted, make sure\nnobody else has claimed it. To do this, look at the "Owned by" section of\nthe ticket. If it's assigned to "nobody," then it's available to be claimed.\nOtherwise, somebody else may be working on this ticket. Either find another\nbug/feature to work on, or contact the developer working on the ticket to\noffer your help. If a ticket has been assigned for weeks or months without\nany activity, it's probably safe to reassign it to yourself. If a ticket\nhasn't been approved yet, join the conversation.
Logáil isteach i do chuntas, mura bhfuil tú cheana féin, trí chliceáil “Logáil Isteach GitHub” nó “Logáil Isteach DjangoProject” ar an taobh clé uachtarach den leathanach ticéad. Nuair a bheidh tú logáilte isteach, is féidir leat an cnaipe “Athraigh Ticéad” a chliceáil in aice le bun an leathanaigh.
Éileamh an ticéad trí chliceáil ar an gcnaipe raidió “sannadh chuig” sa chuid “Gníomhaíocht”. Líonfar d'ainm úsáideora sa bhosca téacs de réir réamhshocraithe.
Finally, click the "Submit changes" button at the bottom to save.
Nuair a bheidh ticéad éileamh agat, tá freagracht agat oibriú ar an ticéad sin ar bhealach réasúnta tráthúil. Mura bhfuil am agat oibriú air, déan é a éileamh nó ná éileamh é ar an gcéad dul síos!
\nMura bhfuil aon chomhartha dul chun cinn ar thicéad éilimh áirithe ar feadh seachtaine nó dhó, féadfaidh forbróir eile iarraidh ort an t-éileamh ticéad a fhágáil ionas nach mbeidh sé monaplaithe a thuilleadh agus gur féidir le duine eile é a éileamh.
\nMá éiligh tú ticéad agus má thógann sé tamall fada (laethanta nó seachtainí) chun cóid a dhéanamh, coinnigh gach duine ar an dáta trí thuairimí a phostáil ar an ticéad. Mura gcuireann tú nuashonruithe rialta ar fáil, agus mura bhfreagraíonn tú iarratas ar thuarascáil ar dhul chun cinn, féadfar d'éileamh ar an ticéad a chúlghairm.
\nMar is gnách, is fearr níos mó cumarsáide ná níos lú cumarsáide!
\nTá sé ró-mhór dul trí na céimeanna chun ticéid a éileamh i gcásanna áirithe.
\nI gcás athruithe beaga, mar shampla clóscríobh sa dhoiciméadú nó fabhtanna beaga nach dtógfaidh ach cúpla nóiméad iad a shocrú, ní gá duit léim trí chrupaí ticéid a éileamh. Cuir isteach d'athruithe go díreach agus tá tú déanta!
\nIt is always acceptable, regardless of whether someone has claimed it or not,\nto link proposals to a ticket if you happen to have the changes ready.
\nDéan cinnte go gcomhlíonann aon ranníocaíocht atá agat na ceanglais seo a leanas ar a laghad:
\nThe code required to fix a problem or add a feature is an essential part\nof a solution, but it is not the only part. A good fix should also include a\nregression test to\nvalidate the behavior that has been fixed and to prevent the problem from\narising again. Also, if some tickets are relevant to the code that you've\nwritten, mention the ticket numbers in some comments in the test so that one\ncan easily trace back the relevant discussions after your patch gets\ncommitted, and the tickets get closed.
Má chuireann an cód gné nua leis, nó má athraíonn sé iompar gné atá ann cheana, ba cheart go mbeadh cáipéisíocht san athrú freisin.
When you think your work is ready to be reviewed, send a GitHub pull\nrequest. If you can't\nsend a pull request for some reason, you can also use patches in Trac. When\nusing this style, follow these guidelines.
\nCuir isteach paistí san fhormáid a thugtar ar ais leis an ordú git diff.
Ceangail paistí le ticéad sa rianaitheoir ticéad, ag baint úsáide as an gcnaipe “comhad ceangail”. * Ná cuir an paiste sa tuairisc nó trácht ar an ticéad mura bhfuil paiste líne amháin ann.
Ainmnigh an comhad paiste le síneadh .diff`; ligfidh sé seo don rianaitheoir ticéad aibhsiú comhréireachta ceart a chur i bhfeidhm, rud atá cabhrach go leor.
Beag beann ar an mbealach a chuireann tú do chuid oibre isteach, lean na céimeanna seo.
\n<patch-review-checklist>Déan cinnte go gcomhlíonann do chód na riachtanais inár: ref: `seicliosta ranníocaíochta `.
Seiceáil an bosca “Tá paiste” ar an ticéad agus déan cinnte nach ndéantar na boscaí “Doiciméadú riachtanais”, “Tástálacha riachtanais”, agus “Feabhsú riachtanais” a sheiceáil. Fágann sé sin go bhfuil an ticéad le feiceáil sa scuaine “Paistí a theastaíonn athbhreithniú” ar an “dashboard Forbartha” _.
Teastaíonn plé pobail níos leithne nuair a thugann paiste feidhmiúlacht nua Django isteach agus déanann sé cinneadh dearaidh de chineál éigin. Tá sé seo tábhachtach go háirithe má bhaineann leis an gcur chuige a: ref: `diprecation <deprecating-a-feature>`nó má thugann sé athruithe briseadh isteach.
\nSeo a leanas cur chuige éagsúla chun aiseolas a fháil ón bpobal.
\nIf you have an idea for a new feature, please create a new proposal (or join an\nexisting discussion) following the process for suggesting new features. You should explain the need for the change, go into\ndetails of the approach and discuss alternatives.
\nYou can propose a change (that is not a new feature idea) on the\nDjango Forum. You should explain the need for the change, go into details of\nthe approach and discuss alternatives.
\nCuir nasc chuig díospóireachtaí den sórt sin i do chuid tuairimí.
\nNí ghlacann Django le gnéithe turgnamhacha. <internal-release-deprecation-policy>Caithfidh gach gné ár n:ref: `beartas díréachtaithe `a leanúint. Dá bhrí sin, féadfaidh sé míonna nó blianta a thógáil ar Django athrú ar dhearadh API.
\nMá theastaíonn aiseolas úsáideora uait ar chomhéadan poiblí, is fearr pacáiste tríú páirtí a chruthú ar dtús. Is féidir leat athrá a dhéanamh ar an API poiblí i bhfad níos gasta, agus an gá atá leis an ngné a bhailíochtú freisin.
\nOnce this package becomes stable and there are clear benefits of incorporating\naspects into Django core, the next step is to propose its inclusion by\nfollowing the process for suggesting new features.
\nCosúil le PEPanna Python, tá `Tograí Feabhsaithe Django `_ nó DEPanna ag Django. Is doiciméad dearaidh é DEP a sholáthraíonn faisnéis do phobal Django, nó a dhéanann cur síos ar ghné nó próiseas nua do Django. Soláthraíonn siad sonraíochtaí teicniúla gonta de ghnéithe, mar aon le réasúnaí. Is iad DEPanna an príomh-mheicníocht freisin chun ionchur pobail a mholadh agus a bhailiú ar phríomhghnéithe nua.
\nBefore considering writing a DEP, it is recommended to first open a discussion\nfollowing the process for suggesting new features.\nThis allows the community to provide feedback and helps refine the proposal.\nOnce the DEP is ready, the Steering Council votes on\nwhether to accept it.
\nRoinnt samplaí de DEPanna atá ceadaithe agus curtha i bhfeidhm go hiomlán:
\n< https://github.com/django/deps/blob/main/final/0181-orm-expressions.rst>`DEP 181: Expressions ORM `_
< https://github.com/django/deps/blob/main/final/0182-multiple-template-engines.rst>`DEP 182: Innill Teimpléad Iolracha `_
< https://github.com/django/deps/blob/main/final/0201-simplified-routing-syntax.rst>`DEP 201: Syntax ródú simplithe `_
Tá cúpla cúis ann go bhféadfadh cód i Django a dhíchur:
\nMá tá gné feabhsaithe nó modhnaithe ar bhealach atá neamhchomhoiriúnach le cúlra, déanfar an sean-ghné nó an t-iompar a dhíchur.
Uaireanta cuimsíonn Django backport de leabharlann Python nach bhfuil san áireamh i leagan de Python a thacaíonn Django faoi láthair. Nuair nach gá Django tacú leis an leagan níos sine de Python nach n-áirítear an leabharlann a thuilleadh, déanfar an leabharlann a dhíchur i Django.
Mar a thuairiscíonn an:ref: beartas díscoireach <internal-release-deprecation-policy>, ba cheart don chéad scaoileadh de Django a dhíspreagann gné (A.B`) removedindjangoxxWarning a ardú (áit gurb é XX an leagan Django ina mbainfear an ghné) nuair a ghairmtear an ghné díscoite. Ag glacadh leis go bhfuil clúdach maith tástála againn, déantar na rabhaidh seo a thiontú go earráidí nuair: ref: reáchtáil an tsraith tástála <running-unit-tests>`le rabhaidh cumasaithe: ``python -Wa runtests.py`. Dá bhrí sin, nuair a chuireann tú removedindjangoxxWarning, ní mór duit deireadh a chur le haon rabhaidh a ghintear agus na tástálacha á reáchtáil agat.
Is é an chéad chéim ná aon úsáid a bhaint as an iompar dlús ag Django féin. Ansin is féidir leat rabhaidh a thostú i dtástálacha a thástáil i ndáiríre an t-iompar míchuir tríd an maisitheoir `ignore_warnings ``a úsáid, ag an leibhéal tástála nó ag an rang:
\nI dtástáil áirithe:
\nfrom django.test import ignore_warnings\nfrom django.utils.deprecation import RemovedInDjangoXXWarning\n\n\n@ignore_warnings(category=RemovedInDjangoXXWarning)\ndef test_foo(self): ...\nMaidir le cás tástála iomlán:
\nfrom django.test import ignore_warnings\nfrom django.utils.deprecation import RemovedInDjangoXXWarning\n\n\n@ignore_warnings(category=RemovedInDjangoXXWarning)\nclass MyDeprecatedTests(unittest.TestCase): ...\nBa chóir duit tástáil a chur leis freisin maidir leis an rabhadh díscrúdaithe:
\nfrom django.utils.deprecation import RemovedInDjangoXXWarning\n\n\ndef test_foo_deprecation_warning(self):\n msg = "Expected deprecation message"\n with self.assertWarnsMessage(RemovedInDjangoXXWarning, msg) as ctx:\n # invoke deprecated behavior\n ...\n self.assertEqual(ctx.filename, __file__)\nTá sé tábhachtach trácht ``RemovedindjangoXXWarning` a chur san áireamh thuas an chód nach bhfuil aon tagairt rabhaidh aige, ach go gcaithfear é a athrú nó a bhaint nuair a chríochnaíonn an díghabháil. D'fhéadfadh sé seo a bheith san áireamh crúcaí a cuireadh leis chun an t-iompar roimhe seo a choinneáil, nó míreanna neamhspleácha nach bhfuil gan ghá nó neamhúsáidte nuair a chríochnaíonn Mar shampla:
\nimport warnings\nfrom django.utils.deprecation import RemovedInDjangoXXWarning, django_file_prefixes\n\n\n# RemovedInDjangoXXWarning.\ndef old_private_helper():\n # Helper function that is only used in foo().\n pass\n\n\ndef foo():\n warnings.warn(\n "foo() is deprecated.",\n category=RemovedInDjangoXXWarning,\n skip_file_prefixes=django_file_prefixes(),\n )\n old_private_helper()\n ...\nFaoi dheireadh, tá cúpla nuashonrú ar dhoiciméadú Django le déanamh:
\nMá dhéantar an ghné atá ann cheana doiciméadaithe, déan é a mharcáil go díluasaithe i ndoiciméadú ag baint úsáide as an anótáil .. diúscartha:: A.B. Cuir tuairisc ghearr agus nóta faoin gcosán uasghrádaithe más infheidhme.
Cuir cur síos ar an iompar míchuir, agus an cosán uasghrádaithe más infheidhme, leis na nótaí scaoileadh reatha (Docs/releases/A.B.txt`) faoin gceannteideal “Gnéithe a dhíchur in AB”.
Cuir iontráil san amlíne díscrúdaithe (docs/internals/deprecation.txt) faoin leagan cuí ag cur síos ar an gcód a bhainfear.
Nuair a bheidh na céimeanna seo críochnaithe agat, tá tú críochnaithe leis an díghabháil. I ngach:term: gné scaoileadh `<Feature release>, baintear gach ``RemovedindJangOxxWarning` a mheaitseálann leis an leagan nua.
\nThe django.utils.deprecation module provides some helpful deprecation\nutilities, such as a @deprecate_posargs decorator to assist with converting\npositional-or-keyword arguments to keyword-only. See the inline documentation\nin the module source.
It's important to test local changes using a Django project. This allows\nensuring that the changes behave as expected in a real environment, especially\nfor user-facing features such as templates, forms, or the admin.
\nTo do this:
\nCreate a virtual environment and install the cloned copy of Django in\neditable mode.
Set up a Django project outside the source tree (you can use the first\npart of the tutorial for guidance).
With this setup, any changes made to the Django checkout will take effect\nimmediately in the test project, allowing manual testing of contributions\nagainst a new or existing app.
\nLe haghaidh faisnéise maidir le ranníocaíochtaí JavaScript, féach an doiciméadach:ref: javascript-patches.
\nBa cheart go soláthródh paistí a bhfuil sé mar aidhm acu feabhas feidhmíochta a sheachadadh tagarmharcanna a thaispeánann iarmhairt an phaiste agus ina dhiaidh sin agus na horduithe a roinnt le hathbhreithneoirí a atáirgeadh.
\ndjango-asvLink to this heading#Monatóireacht django-asv ar fheidhmíocht cód Django le himeacht ama. Is féidir na tagarmharcanna seo a reáchtáil ar iarratas tarraingthe tríd an iarraidh tarraingthe a lipéadú le “tagarmharc”. Spreagtar go mór leis na tagarmharcanna seo a chur leis.
\nUse this checklist to review a pull request. If this contribution would not be\nconsidered trivial, first ensure it has an accepted\nticket before proceeding with the review.
\nIf the pull request passes all the criteria below and is not your own, please\nset the "Triage Stage" on the corresponding Trac ticket to "Ready for checkin".\nIf you've left comments for improvement on the pull request, please tick the\nappropriate flags on the Trac ticket based on the results of your review:\n"Patch needs improvement", "Needs documentation", and/or "Needs tests". As time\nand interest permit, mergers do final reviews of "Ready for checkin" tickets\nand will either commit the changes or bump it back to "Accepted" if further\nwork needs to be done.
\nIf you're looking to become a member of the triage & review team, doing\nthorough reviews of contributions is a great way to earn trust.
\nAg lorg paiste le hathbhreithniú? Amharc ar an rannán "Paistí a dteastaíonn athbhreithniú uathu" den Phainéal Forbartha Django <https://dashboard.djangoproject.com/>`_.
\nAg iarraidh d'iarratas tarraingthe a athbhreithniú Déan cinnte go bhfuil bratacha Trac ar an ticéad socraithe ionas go mbeidh an ticéad le feiceáil sa scuaine sin.
\n<committing-guidelines>An bhfuil an t-iarratas tarraingthe ná tiomantas aonair le teachtaireacht a leanann inn:ref: `formáid teachtaireachta comhartha `?
Are you the patch author and a new contributor? Please add yourself to the\nAUTHORS file. At your option, submit a\nContributor License Agreement.
Does this have an accepted ticket on Trac? All contributions require a ticket\nunless the change is considered trivial.
Does the coding style conform to our\nguidelines? Are there any black, blacken-docs, flake8,\nisort, or zizmor errors? You can install the pre-commit hooks to automatically catch these errors.
Má tá an t-athrú ag teacht ar ais ar bhealach ar bith, an bhfuil nóta sna nótaí scaoilte (Docs/releases/a.b.txt`)?
An bhfuil sraith tástála Django ag rith?
If there is a code coverage report\ncomment on the pull request, have you reviewed the missing coverage in\ncontext (considering database/platform-specific limitations)?
If the change affects the Django admin or rendered HTML output, has\naccessibility testing been done?
An dtógann an doiciméadú gan aon earráidí (make html, nó make.bat html ar Windows, ón eolaire ``docs`)?
An leanann an doiciméadú na treoirlínte stíl scríbhneoireachta in:doc: `/inmheán/ranníoc/scríbhneoireach-doiciméadúcháin `?
<documentation-spelling-check>An bhfuil aon earráidí litrithe ann: ref: `earráidí litrithe `?
An bhfuil tástáil cheart aischéimnithí ann (ba cheart go dteipfeadh ar an tástáil sula gcuirtear an deisiú i bhfeidhm)?
Más fabht é a cháilíonn :ref:` le haghaidh cúlport <supported-versions-policy>` chuig an leagan cobhsaí de Django, an bhfuil nóta eisiúna in docs/releases/A.B.C.txt? Ní gá nóta scaoilte a bheith ag ceartúcháin fabhtanna a chuirfear i bhfeidhm sa phríomhbhrainse amháin.
An bhfuil tástálacha ann chun an cód nua go léir a “feidhmiú”?
An bhfuil nóta scaoileadh i Docs/releases/a.b.txt`?
An bhfuil cáipéisíocht ann don ghné agus an bhfuil sé: ref: anótáilte go cuí `le <documenting-new-features>`.. leaganadded:: A.B`` nó .. leaganmodified:: A.B?
Féach an treor:ref: deprecating-a-feature.
\n