Ticéid triailLink to this heading#

Sreabhadh oibre triageLink to this heading#

Unfortunately, not all reports in the ticket tracker provide all the required details. A number of tickets have proposed solutions, but those don't necessarily meet all the requirements adhering to the guidelines for contributing.

Bealach amháin le cabhrú amach is ea ticéid a chruthaigh úsáideoirí eile trialó.

<triage-stages>Tá an chuid is mó den sreabhadh oibre bunaithe ar choincheap an ticéad: ref: `céimeanna triage `. Déanann gach céim cur síos ar an áit a bhfuil ticéad ar leith ag am ar bith i rith a shaoil. In éineacht le dornán bratacha, insíonn an tréith seo dúinn go héasca cad agus cé a bhfuil gach ticéad ag fanacht air.

Ós rud é gur fiú míle focal pictiúr, tosaímid ansin:

Tá dhá ról againn sa léaráid seo:

• Cumaisc: daoine a bhfuil rochtain tiomanta acu atá freagrach as an gcinneadh deiridh a dhéanamh athrú a chumasc.

• Trialóirí ticéad: duine ar bith i bpobal Django a roghnaíonn páirt a bheith páirteach i bpróiseas forbartha Django. Fágtar ár suiteáil Trac ar oscailt don phobal d'aon ghnó, agus is féidir le duine ar bith ticéid a thrialú. <how-can-i-help-with-triaging>Is tionscadal pobail é Django, agus spreagaimid:ref: `triage ag an bpobal `.

Mar shampla, feicimid saolré meánticéad anseo:

• Cruthaíonn Alice ticéad agus seolann sí iarratas tarraingt neamhiomlán (gan tástálacha, cur i bhfeidhm mícheart).

• Athbhreithníonn Bob an t-iarratas tarraingt, marcálann sé an ticéad mar "Glactha", "tástálacha riachtanas", agus "feabhsaítear an paiste", agus fágann sé nóta ag insint do Alice conas a d'fhéadfaí an paiste a fheabhsú.

• Nuashonraíonn Alice an iarratas tarraingthe, ag cur tástálacha leis (ach gan an cur i bhfeidhm a athrú) Baineann sí an dá bhratach.

• Déanann Charlie athbhreithniú ar an iarratas tarraingt agus athshocraíonn sé an bhratach “feabhas ar an bpaiste” le trácht eile ar an gcur i bhfeidhm a fheabhsú.

• Nuashonraíonn Alice an t-iarratas tarraingthe, ag socrú an cur chun Baineann sí an bratach “is gá feabhsú ar phaiste”.

• Déanann Daisy athbhreithniú ar an iarratas tarraingthe agus marcálann an ticéad mar “Réidh le seiceáil”.

• Jacob, a: ref: cumaisc <mergers-team>, athbhreithniú ar an iarraidh tarraingthe agus cumasc é.

Teastaíonn i bhfad níos lú aiseolais ná seo le roinnt ticéid, ach ansin arís bíonn i bhfad níos mó ag teastáil ó roinnt ticéid.

Céimeanna triageLink to this heading#

Anseo thíos déanaimid cur síos níos mionsonraithe ar na céimeanna éagsúla a bhféadfadh ticéad dul tríd le linn a shaolré.

Tréithe triage eileLink to this heading#

Is féidir roinnt bratacha, atá le feiceáil mar bhosca seiceála i Trac, a shocrú ar thicéad:

Ticéid DúntaLink to this heading#

Nuair a bheidh a shaolré úsáideach críochnaithe ag ticéad, tá sé in am é a dhúnadh. Is freagracht mhór é ticéad a dhúnadh, áfach. Caithfidh tú a bheith cinnte go bhfuil an cheist réiteach i ndáiríre, agus ní mór duit a choinneáil i gcuimhne nach mbeadh tuairisceoir an ticéad sásta a dticéad a bheith dúnta (mura bhfuil sé socraithe!). Mura bhfuil tú cinnte faoi ticéad a dhúnadh, fág trácht le do chuid smaointe ina ionad sin.

Má dhúnann tú ticéad, ba cheart duit na rudaí seo a leanas a chinntiú i gcónaí:

• Bí cinnte go bhfuil an cheist réiteach.

• Fág trácht a mhíníonn an cinneadh an ticéad a dhúnadh.

• Má tá bealach ann gur féidir leo an ticéad a fheabhsú chun é a athoscailt, cuir in iúl dóibh.

• Más dúblach an ticéad, déan tagairt don ticéad bunaidh. Déan crostagairt freisin don ticéad dúnta trí nóta tráchta a fhágáil sa bhuntéacs -- ceadaíonn sé seo rochtain a fháil ar fhaisnéis níos gaolmhaire faoin bhfabht tuairiscithe nó faoin ngné iarrtha.

• Bí póilíneach. Ní maith le duine ar bith a dticéad a bheith dúnta. D'fhéadfadh sé a bheith frustrach nó fiú díspreagach. Is é an bealach is fearr chun daoine a chasadh as cur le Django ná a bheith béasach agus cairdiúil agus moltaí a thairiscint maidir le conas a d'fhéadfaidís an ticéad seo agus na ticéid eile a fheabhsú sa todhchaí.

Is féidir ticéad a réiteach ar roinnt bealaí:

• socraithe

  Úsáidtear nuair a bheidh paiste rollta isteach i Django agus socraítear an tsaincheist.

• neamhbhailí

  Úsáidtear má aimsítear go bhfuil an ticéad mícheart. Ciallaíonn sé seo go bhfuil an tsaincheist sa ticéad mar thoradh ar earráid úsáideora i ndáiríre, nó go ndéanann sé cur síos ar fhadhb le rud éigin seachas Django, nó nach tuarascáil fabht nó iarratas ar ghné í ar chor ar bith (mar shampla, cuireann roinnt úsáideoirí nua ceisteanna tacaíochta mar thicéid).

• wontfix

  Used when someone decides that the request isn't appropriate for consideration in Django. Sometimes a ticket is closed as "wontfix" with a request for the reporter to start a discussion on the Django Forum if they feel differently from the rationale provided by the person who closed the ticket. Other times, a discussion precedes the decision to close a ticket. Always use the forum to get a consensus before reopening tickets closed as "wontfix".

• dúbailt

  Úsáidtear nuair a chlúdaíonn ticéad eile an cheist chéanna. Trí thicéid dúblacha a dhúnadh, coinnímid an plé go léir in aon áit amháin, rud a chuidíonn le gach duine.

• worksforme

  Úsáidtear nuair nach bhfuil go leor sonraí sa ticéad chun an fabht bunaidh a mhacasamhlú.

• eolas riachtanais

  Úsáidtear é nuair nach mbíonn go leor faisnéise sa ticéad chun an tsaincheist tuairiscithe a mhacasamhlú ach go bhféadfadh sé a bheith bailí fós. Ba cheart an ticéad a athoscailt nuair a chuirtear tuilleadh eolais ar fáil.

If you believe that the ticket was closed in error -- because you're still having the issue, or it's popped up somewhere else, or the triagers have made a mistake -- please reopen the ticket and provide further information. Again, please do not reopen tickets that have been marked as "wontfix" and bring the issue to the Django Forum instead.

Conas is féidir liom cabhrú le triaging?Link to this heading#

Tá an próiseas triage á thiomáint go príomha ag baill an phobail. I ndáiríre, is féidir le haon éig** cabhrú.

Chun páirt a ghlacadh, tosú trí cuntas a chruthú ar Trac. 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.

Ansin, is féidir leat cabhrú amach trí:

• Ticéid “Neamhathbhreithnithe” a dhúnadh mar “neamhbhailí”, “worksforme”, nó “dúblach”, nó “wontfix”.

• Closing "Unreviewed" tickets as "needsinfo" when the description is too sparse to be actionable.

• Na bratacha “Tástálacha Riachtanais”, “Doiciméadú riachtanais”, nó bratacha “Tá paiste” a cheartú le haghaidh ticéid ina bhfuil siad socraithe go mícheart.

• Ag socrú an bhratach “Easy picings`_” le haghaidh ticéid atá beag agus réasúnta simplí.

• Socraigh an cineál* ticéad atá fós gan catagóir.

• Seiceáil go bhfuil sean-ticéid fós bailí. Mura bhfaca ticéad aon ghníomhaíocht le fada an lá, is féidir go bhfuil an fhadhb socraithe ach níor dúnadh an ticéad fós.

• Identifying trends and themes in the tickets. If there are a lot of bug reports about a particular part of Django, it may indicate we should consider refactoring that part of the code. If a trend is emerging, you should raise it for discussion (referencing the relevant tickets) on the Django Forum.

• Fíoraigh an bhfuil réitigh a chuireann daoine eile isteach ceart. Má tá siad ceart agus má tá cáipéisíocht agus tástálacha iomchuí iontu freisin, bog iad go dtí an chéim “Réidh le haghaidh Seiceála”. Mura bhfuil siad ceart ansin fág trácht chun míniú cén fáth agus na bratacha comhfhreagracha a shocrú (“Teastaíonn feabhsú ar phaiste”, “Tástálacha riachtanais” srl.).

Mar sin féin, iarrann muid an méid seo a leanas ó gach ball ginearálta pobail atá ag obair sa bhunachar sonraí ticéad:

• Le do thoil, **ná cuir do thicéid féin a chur chun cinn go “Réidh le seiceáil”. Féadfaidh tú ticéid daoine eile a rinne tú athbhreithniú a mharcáil mar “Réidh le seiceáil”, ach ba cheart duit ball pobail amháin eile a fháil ar a laghad chun paiste a chuireann tú isteach a athbhreithniú.

• Please don't reverse a decision without posting a message to the Django Forum to find consensus.

• If you're unsure if you should be making a change, don't make the change but instead leave a comment with your concerns on the ticket, or post a message to the Django Forum. It's okay to be unsure, but your input is still valuable.

Aischéimniú a dhíghiltLink to this heading#

Is fabht é aischéimniú atá i láthair i roinnt leagan níos nuaí de Django ach ní i gceann níos sine. Píosa faisnéise thar a bheith cabhrach is ea an tiomantas a thug isteach an aischéimniú. Cuidíonn eolas a fháil ar an ngealltanas a bhí ina chúis leis an athrú ar iompar a aithint an raibh an t-athrú d'aon ghnó nó an raibh fo-iarsacht neamhthuigneach ann. Seo mar is féidir leat é seo a chinneadh.

Tosaigh trí thástáil aischéimnithe a scríobh do shraith tástála Django don tsaincheist. Mar shampla, ligeanfaimid go bhfuilimid ag dífhabhtú aischéimnithe in imirce. Tar éis duit an tástáil a scríobh agus a dhearbhú go dteipeann air ar an bpríomhbhrainse is déanaí, cuir é i gcomhad ar leithligh ar féidir leat a reáchtáil go neamhspleách Mar shampla, ligeanfaimid go gcruthaíomar tests/migrations/test_regression.py, ar féidir é a reáchtáil le:

$ ./runtests.py migrations.test_regression

Ansin, déanaimid an pointe reatha sa stair a mharcáil mar “dona” ós rud é go dteipeann ar an tástáil:

$ git bisect bad
You need to start by "git bisect start"
Do you want me to do it for you [Y/n]? y

Anois, ní mór dúinn pointe a aimsiú i stair git sula dtugadh isteach an aischéimniú (ie pointe ina dtéann an tástáil). Úsáid rud éigin cosúil le git checkout HEAD~100 chun athbhreithniú níos luaithe a sheiceáil (100 gealltanais níos luaithe, sa chás seo). Seiceáil má theipeann ar an tástáil. Más ea, marcáil an pointe sin mar “olc” (``git bisect bad ``), ansin seiceáil athbhreithniú níos luaithe agus athsheiceáil. Nuair a aimsíonn tú athbhreithniú ina dtéann do thástáil, marcáil é mar “maith”:

$ git bisect good
Bisecting: X revisions left to test after this (roughly Y steps)
...

Anois táimid réidh don chuid spraoi: git bisect run` a úsáid chun an chuid eile den phróiseas a uathoibriú:

$ git bisect run tests/runtests.py migrations.test_regression

Ba cheart go bhfeicfeá git bisect úsáid a bhaint as cuardach dénártha chun na hathbhreithnithe idir maith agus olc a sheiceáil amach go huathoibríoch go dtí go bhfaighidh sé an chéad ghealltanas "olc" nuair a theipeann ar an tástáil.

Anois, tuairiscigh do thorthaí ar an ticéad Trac, agus cuir an tástáil aischéimnithe mar cheangaltán le do thoil. Nuair a scríobhann duine socrú don fhabht, beidh do thástáil acu cheana féin mar phointe tosaigh.