Ranníocaí a chur isteachLink to this heading#

Socruithe clóscríbe agus athruithe doiciméadaitheLink to this heading#

Má 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.

Féach in:doc: working-with-git le haghaidh tuilleadh sonraí maidir le conas iarratais tarraingthe a úsáid.

Ticéid “Éileamh”Link to this heading#

I 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.

Dá 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.

Má 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:

• Logá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 ticket tracker. Remember that proposals for new features should follow the 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.

Stíl ranníocaíochtaLink to this heading#

Déan cinnte go gcomhlíonann aon ranníocaíocht atá agat na ceanglais seo a leanas ar a laghad:

• Is 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.

• Cuir 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.

• <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” _.

Ranníocaí a dteastaíonn aiseolasLink to this heading#

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.

Seo a leanas cur chuige éagsúla chun aiseolas a fháil ón bpobal.

Gné a dhíspreagadhLink to this heading#

Tá cúpla cúis ann go bhféadfadh cód i Django a dhíchur:

• Má 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:

1. I dtástáil áirithe:

   Code

   from django.test import ignore_warnings
   from django.utils.deprecation import RemovedInDjangoXXWarning
   
   
   @ignore_warnings(category=RemovedInDjangoXXWarning)
   def test_foo(self): ...
   

2. Maidir le cás tástála iomlán:

   Code

   from django.test import ignore_warnings
   from django.utils.deprecation import RemovedInDjangoXXWarning
   
   
   @ignore_warnings(category=RemovedInDjangoXXWarning)
   class MyDeprecatedTests(unittest.TestCase): ...
   

Ba chóir duit tástáil a chur leis freisin maidir leis an rabhadh díscrúdaithe:

from django.utils.deprecation import RemovedInDjangoXXWarning


def test_foo_deprecation_warning(self):
    msg = "Expected deprecation message"
    with self.assertWarnsMessage(RemovedInDjangoXXWarning, msg) as ctx:
        # invoke deprecated behavior
        ...
    self.assertEqual(ctx.filename, __file__)

Tá 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:

import warnings
from django.utils.deprecation import RemovedInDjangoXXWarning


# RemovedInDjangoXXWarning.
def old_private_helper():
    # Helper function that is only used in foo().
    pass


def foo():
    warnings.warn(
        "foo() is deprecated.",
        category=RemovedInDjangoXXWarning,
        stacklevel=2,
    )
    old_private_helper()
    ...

Faoi dheireadh, tá cúpla nuashonrú ar dhoiciméadú Django le déanamh:

1. Má 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.

2. 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”.

3. 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.

Testing with a Django projectLink to this heading#

It's important to test local changes using a Django project. This allows ensuring that the changes behave as expected in a real environment, especially for user-facing features such as templates, forms, or the admin.

To do this:

1. Create a virtual environment and install the cloned copy of Django in editable mode.

2. Set up a Django project outside the source tree (you can use the first part of the tutorial for guidance).

With this setup, any changes made to the Django checkout will take effect immediately in the test project, allowing manual testing of contributions against a new or existing app.

Ranníocaíochtaí JavaScriptLink to this heading#

Le haghaidh faisnéise maidir le ranníocaíochtaí JavaScript, féach an doiciméadach:ref: javascript-patches.

Paistí optamaitheLink to this heading#

Ba 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.

Seicliosta ranníocaíochtaLink to this heading#

Use this checklist to review a pull request. If this contribution would not be considered trivial, first ensure it has an accepted ticket before proceeding with the review.

If the pull request passes all the criteria below and is not your own, please set the "Triage Stage" on the corresponding Trac ticket to "Ready for checkin". If you've left comments for improvement on the pull request, please tick the appropriate flags on the Trac ticket based on the results of your review: "Patch needs improvement", "Needs documentation", and/or "Needs tests". As time and interest permits, mergers do final reviews of "Ready for checkin" tickets and will either commit the changes or bump it back to "Accepted" if further work needs to be done.

If you're looking to become a member of the triage & review team, doing thorough reviews of contributions is a great way to earn trust.

Ag lorg paiste le hathbhreithniú? Amharc ar an rannán "Paistí a dteastaíonn athbhreithniú uathu" den Phainéal Forbartha Django <https://dashboard.djangoproject.com/>`_.

Ag 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.