Comhairle do rannpháirtithe nuaLink to this heading

Ranníocóir nua agus nach bhfuil cinnte cad atá le déanamh? Ar mhaith leat cabhrú ach níl a fhios agat conas tosú? Is é seo an chuid duitse.

Tá comhairle níos ginearálta ar an leathanach seo maidir le bealaí is féidir leat cur le Django, agus conas dul chuige sin.

Má tá tú ag lorg teistiméireachta ar na sonraí maidir le ranníocaíochtaí cód a dhéanamh, féach an doiciméadú /inmheánach/ranníocaíocht/cód-scríobh/innéacs.

Na chéad chéimeannaLink to this heading

Tosaigh leis na céimeanna seo chun próiseas forbartha Django a fháil amach.

Ticéid triageLink to this heading

If an unreviewed ticket reports a bug, try and reproduce it. If you can reproduce it and it seems valid, make a note that you confirmed the bug and accept the ticket. Make sure the ticket is filed under the correct component area. Consider writing a patch that adds a test for the bug's behavior, even if you don't fix the bug itself. See more at How can I help with development?.

Athbhreithniú ar phaistí ticéidLink to this heading

Cuideoidh sé seo leat eolas a thógáil ar an mbunachar cóid agus ar na próisis. Marcáil na bratacha cuí má theastaíonn doiciméid nó tástálacha ó phaiste. Féach tríd na hathruithe a dhéanann paiste, agus coinnigh súil amach ar chomhréireacht atá neamhchomhoiriúnach le leaganacha níos sine ach le tacaíocht fós de Python. :doc: `Rith na tástálacha' agus déan cinnte go d</internals/contributing/writing-code/unit-tests> téann siad. Nuair is féidir agus ábhartha, bain triail as iad ar bhunachar sonraí seachas SQLite. Fág tuairimí agus aiseolas!

Coinnigh sean-phaistí cothromLink to this heading

Oftentimes the codebase will change between a patch being submitted and the time it gets reviewed. Make sure it still applies cleanly and functions as expected. Updating a patch is both useful and important! See more on Seicliosta ranníocaíochta.

Scríobh roinnt doiciméadLink to this heading

Django's documentation is great but it can always be improved. Did you find a typo? Do you think that something should be clarified? Go ahead and suggest a documentation patch! See also the guide on Scríobh cáipéis.

Sínigh an Chomhaontú CeadúnaisLink to this heading

The code that you write belongs to you or your employer. If your contribution is more than one or two lines of code, you have the option to sign the CLA. See the Contributor License Agreement FAQ for a more thorough explanation.

TreorlínteLink to this heading

Mar núíosach ar thionscadal mór, is furasta frustrachas a fháil. Seo roinnt comhairle chun do chuid oibre ar Django a dhéanamh níos úsáideach agus níos luachmhaire.

Roghnaigh réimse ábhairLink to this heading

Ba chóir go mbeadh sé seo rud a bhfuil cúram ort faoi, a bhfuil eolas agat air nó ar mhaith leat foghlaim faoi. Ní gá duit a bheith ina shaineolaí cheana féin ar an réimse is mian leat oibriú air; bíonn tú i do shaineolaí trí do chuid ranníocaíochtaí leanúnacha leis an gcód.

Déan anailís ar chomhthéacs agus stair ticLink to this heading

Ní iomlán é Trac; tá an comhthéacs chomh tábhachtach leis na focail. Agus Trac á léamh agat, ní mór duit a chur san áireamh cé a deir rudaí, agus nuair a dúradh iad. Ní gá go gciallaíonn tacaíocht do smaoineamh dhá bhliain ó shin go mbeidh tacaíocht ag an smaoineamh fós. Ní mór duit aird a thabhairt freisin ar cé náir* labhair - mar shampla, mura raibh ranníocóir a bhfuil taithí acu páirteach i bplé le déanaí, ansin b'fhéidir nach mbeidh an tacaíocht a theastaíonn ag ticéad chun dul isteach i Django.

Tosaigh beagLink to this heading

Tá sé níos éasca aiseolas a fháil ar cheist bheag ná ar cheann mór. Féach na “roghnaithe éasca” _.

Deimhnigh tacaíocht sula ndéanann tú tasc mórLink to this heading

Ciallaíonn sé seo duine eile a fháil chun a dheimhniú go bhfuil fabht fíor sula ndéanann tú an cheist a shocrú, agus a chinntiú go bhfuil comhaontú ar ghné atá beartaithe sula dtéann tú i bhfeidhm í.

Bí trom! Fág aiseolas!Link to this heading

Uaireanta is féidir go mbeadh sé scanrúil do thuairim a chur amach don domhan agus a rá “tá an ticéad seo ceart” nó “teastaíonn obair ón bpaiste seo”, ach is é seo an t-aon bhealach a bhogann an tionscadal ar aghaidh. Bíonn tionchar i bhfad níos mó ag ranníocaíochtaí pobal leathan Django sa deireadh ná tionchar ag aon duine amháin. Ní féidir linn é a dhéanamh gan**tús**!

Bí cúramach agus rudaí á mharcáil “Réidh le Seiceáil isteach”Link to this heading

Mura bhfuil tú cinnte i ndáiríre an bhfuil ticéad réidh, ná déan é a mharcáil mar sin. Fág trácht ina ionad sin, ag cur in iúl do chuid smaointe do dhaoine eile. Má tá tú cinnte den chuid is mó, ach nach bhfuil tú cinnte go hiomlán, b'fhéidir go ndéanfá iarracht a iarraidh ar an gcainéal #contributing -getting-started sa fhreastalaí Django Discord chun a fheiceáil an féidir le duine eile d'amhras a dhearbhú.

Fan le haghaidh aiseolas, agus freagra ar aiseolas a fhaigheann túLink to this heading

Dírigh ar thicéad amháin nó dhó, féach iad ó thús go deireadh, agus déan arís. Críochnaíonn an cur chuige gunna a bhaineann le go leor ticéad a ghlacadh agus ligean do chuid acu titim ar thaobh an bhealaigh níos mó díobhála ná leas.

Bí dianLink to this heading

Nuair a deirimid “:pep: 8, agus caithfimid doiciméid agus tástálacha a bheith againn”, ciallaíonn muid é. Mura bhfuil doiciméid agus tástálacha ag paiste, b'fhearr go mbeadh cúis mhaith ann. Ní bhíonn mórán meáchain ag argóintí mar “Ní raibh mé in ann aon tástálacha atá ann cheana ar an ngné seo a fháil”. Cé go bhféadfadh sé a bheith fíor, ciallaíonn sé sin go bhfuil an post thábhachtach agat na chéad tástálacha a scríobh don ghné sin, ní go bhfaigheann tú pas ó thástálacha scríbhneoireachta ar fad.

Bí foighneachLink to this heading

Ní bhíonn sé éasca i gcónaí do thicéad nó do phaiste a athbhreithniú go tapa. Níl sé seo pearsanta. Tá a lán ticéad agus iarratais tarraingthe ann chun dul tríd.

Tá sé tábhachtach do phaiste a choinneáil suas chun dáta. Déan athbhreithniú ar an ticéad ar Trac chun a chinntiú go ndéantar na bratacha Riachtanas, Doiciméadú Riachtanacha, agus Caithfear feabhsú ar phais a sheiceáil nuair a bheidh aghaidh agat ar gach trácht athbhreithnithe.

Cuimhnigh go bhfuil timthriall scaoilte ocht mhí ag Django, mar sin tá neart ama ann chun do phaiste a athbhreithniú.

Ar deireadh, is féidir le meabhrúchán dea-ama a bheith ina chuidiú. Féach cód ranníocach Ceisteanna Coitianta le haghaidh smaointe anseo.