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.
\nFéach in:doc: working-with-git le haghaidh tuilleadh sonraí maidir le conas iarratais tarraingthe a úsáid.
\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áil isteach ag baint úsáide as do chuntas GitHub `_ nó `cruthaigh cuntas inár gcóras ticéad. Má tá cuntas agat ach má tá dearmad déanta agat ar do phasfhocal, is féidir leat é a athshocrú ag baint úsáide as an leathanach athshocraithe pasfhocal.
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.
Má tá ticéad don tsaincheist seo ann cheana féin, déan cinnte nach éiligh aon duine eile é. Chun seo a dhéanamh, féach ar an gcuid “Úinéireacht ag” den ticéad. Má shanntar é do “duine ar bith,” ansin tá sé ar fáil le héileamh. Seachas sin, d'fhéadfadh duine eile a bheith ag obair ar an ticéad seo. Faigh bot/gné eile le bheith ag obair air, nó déan teagmháil leis an bhforbróir atá ag obair ar an ticéad chun do chabhair a thairiscint. Má shannadh ticéad ar feadh seachtainí nó míonna gan aon ghníomhaíocht, is dócha go bhfuil sé sábháilte é a athshannadh duit féin.
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.
Faoi dheireadh cliceáil ar an gcnaipe “Cuir isteach athruithe” ag an mbun chun sábháil.
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!
\nTá sé inghlactha i gcónaí*, is cuma má éiligh duine é nó nach bhfuil, tograí a nascadh le ticéad má tharlaíonn go bhfuil na hathruithe réidh agat.
\nDéan cinnte go gcomhlíonann aon ranníocaíocht atá agat na ceanglais seo a leanas ar a laghad:
\nIs cuid riachtanach de réiteach é an cód a theastaíonn chun fadhb a shocrú nó gné a chur leis, ach ní hé an t-aon chuid é. Ba cheart go n-áireofaí a: doc: tástá <unit-tests>il aischéimniúna i socrú maith chun an t-iompar atá socraithe a bhailíochtú agus chun an fhadhb a chosc ó eascraíonn arís. Chomh maith leis sin, má tá roinnt ticéid ábhartha don chód a scríobh tú, luaigh na huimhreacha ticéad i roinnt tuairimí sa tástáil ionas gur féidir le duine na díospóireachtaí ábhartha a rianú siar go héasca tar éis do phaiste tiomanta, agus na ticéid a dhúnadh.
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.
<working-with-git>Nuair a cheapann tú go bhfuil do chuid oibre réidh le hathbhreithniú, seol: doc: `iarratas tarraingthe GitHub `. Mura féidir leat iarratas tarraingthe a sheoladh ar chúis éigin, is féidir leat paistí a úsáid i Trac freisin. Agus an stíl seo á úsáid agat, lean na treoirlínte seo.
\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\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 stacklevel=2,\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.
\nIt'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 permits, 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.
\nAn 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.
\nDoes 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 the change affects the Django admin or rendered HTML output, has\naccessibility testing been done?
<committing-guidelines>An bhfuil an t-iarratas tarraingthe ná tiomantas aonair le teachtaireacht a leanann inn:ref: `formáid teachtaireachta comhartha `?
An tusa an t-údar paiste agus ranníocóir nua? Cuir tú féin leis an gcomhad:source: AUTHORS le do thoil agus cuir isteach Comhaontú Ceadúnais Ranníoca.
Does this have an accepted ticket on Trac? All contributions require a ticket\nunless the change is considered trivial.