--- title: "Comhairle do rannpháirtithe nua" version: 5.2 locale: ga source: https://docs.djangoproject.com/ga/5.2/internals/contributing/new-contributors/ canonical: https://djangodocs.dev/ga/5.2/internals/contributing/new-contributors/ --- # Comhairle do rannpháirtithe nua 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éigh suas agus ag rith!** > > Má tá tú nua ag cur le Django, tabharfaidh an rang teagaisc: :doc: /intro/rannpháirtíoch réamhrá duit ar na huirlisí agus ar an sreabhadh oibre. 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éimeanna Tosaigh leis na céimeanna seo chun próiseas forbartha Django a fháil amach. ### Ticéid triage Má thuairiscíonn ticéad gan athbhreithniúnaí' \_ fabht, déan iarracht é a atáirgeadh. Más féidir leat é a atáirgeadh agus is cosúil go bhfuil sé bailí, déan nóta gur dheimhnigh tú an fabht agus glacann tú leis an ticéad. Déan cinnte go bhfuil an ticéad comhdaithe faoin limistéar comhpháirt cheart. Smaoinigh ar phaiste a scríobh a chuireann tástáil ar iompar an fhabhta, fiú mura ndéanann tú an fabht féin a shocrú. Féach tuilleadh ag:ref: \`how can-i-help-with-triaging ### Athbhreithniú ar phaistí ticéid 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\ 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í cothrom Is minic a athróidh an bunachar cóid idir paiste atá á chur isteach agus an t-am a athbhreithniú air. Déan cinnte go bhfuil feidhm aige go glan fós agus feidhmíonn sé mar a bhíothas ag Tá sé úsáideach agus tábhachtach paiste a nuashonrú! Féach tuilleadh ar:doc: scríbhneoireach-code/submitting-patches. ### Scríobh roinnt doiciméad Tá cáipéisíocht Django iontach ach is féidir é a fheabhsú i gcónaí. An bhfuair tú clóscríobh? An gceapann tú gur chóir rud éigin a shoiléiriú? Téigh ar aghaidh agus moladh paiste doiciméadaithe! Féach freisin an treoir ar:doc: scríbhneoireach-doiciméadúcháin . > **Note** > > Tá naisc chuig go leor ceisteanna úsáideacha Trac san [leathanach tuairiscí](https://code.djangoproject.com/wiki/Reports), lena n-áirítear roinnt atá úsáideach chun ticéid a thriail agus chun paistí a athbhreithniú mar a mholtar thuas. ### Sínigh an Chomhaontú Ceadúnais Is leat féin nó le d’fhostóir an cód a scríobhann tú. Má tá do ranníocaíocht níos mó ná líne nó dhó de chód, ní mór duit an [CLA](https://www.djangoproject.com/foundation/cla/) a shíniú. Féach ar an [Ceisteanna Coitianta ar an gComhaontú um Cheadúnas Ranníocóra](https://www.djangoproject.com/foundation/cla/faq/) le haghaidh míniú níos cruinne. ## Treorlínte 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 ábhair 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 tic 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 beag 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ór 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! 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” 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](https://chat.djangoproject.com) 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ú 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í dian 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í foighneach 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](/ga/5.2/faq/contributing/#new-contributors-faq) le haghaidh smaointe anseo.