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.

See Ag obair le Git agus GitHub for more details on how to use pull requests.

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 in using your GitHub account or create an account in our ticket system. If you have an account but have forgotten your password, you can reset it using the password reset page.

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

• If a ticket for this issue already exists and has been accepted, make sure nobody else has claimed it. To do this, look at the "Owned by" section of the ticket. If it's assigned to "nobody," then it's available to be claimed. Otherwise, somebody else may be working on this ticket. Either find another bug/feature to work on, or contact the developer working on the ticket to offer your help. If a ticket has been assigned for weeks or months without any activity, it's probably safe to reassign it to yourself. If a ticket hasn'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.

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:

• The code required to fix a problem or add a feature is an essential part of a solution, but it is not the only part. A good fix should also include a regression test to validate the behavior that has been fixed and to prevent the problem from arising again.

• 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 request. If you can't send a pull request for some reason, you can also use patches in Trac. When using this style, follow these guidelines.

• 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, django_file_prefixes


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


def foo():
    warnings.warn(
        "foo() is deprecated.",
        category=RemovedInDjangoXXWarning,
        skip_file_prefixes=django_file_prefixes(),
    )
    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.

The django.utils.deprecation module provides some helpful deprecation utilities, such as a @deprecate_posargs decorator to assist with converting positional-or-keyword arguments to keyword-only. See the inline documentation in the module source.

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 permit, 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.