Cum alegi modul corect de Refactor

Alegerea modului Refactor ține de limita schimbării, nu doar de numele țintei. Alege modul care se potrivește cu faptul că schimbi instanțe de bloc, referințe către entități partajate sau definiția entității partajate în sine.

Pornește de la limita schimbării #

Un mod Refactor ar trebui ales doar după ce poți descrie limita schimbării în limbaj simplu.

• Schimbă această variantă exactă de bloc acolo unde apare.
• Fă aceste surse potrivite să nu mai refere această entitate partajată.
• Actualizează definiția entității partajate pe care toate referințele ar trebui să o moștenească.

Comparația modurilor #

• block_instance: potrivit când o variantă de bloc din conținutul indexat trebuie înlocuită fără să schimbi o definiție partajată peste tot.
• entity_reference: potrivit când sursele potrivite trebuie să nu mai indice către un pattern, template part sau navigation partajată, iar definiția partajată trebuie să rămână intactă.
• entity_definition: potrivit când pattern-ul, template part-ul sau navigation partajată trebuie actualizată la sursa de adevăr.

Greșeli frecvente la alegerea modului #

• Folosirea entity_definition când doar un subset de referințe ar trebui schimbat poate largi prea mult impactul.
• Folosirea entity_reference când scopul real este editarea definiției partajate poate crea follow-up repetitiv.
• Folosirea block_instance pentru o problemă de tip shared definition poate rata schimbarea mai curată la sursă de adevăr.

Verificări de decizie înainte de preview #

Înainte să previzualizezi batch-ul, parcurge un set scurt de verificări care leagă modul selectat de rezultatul dorit.

• Întreabă-te dacă definiția partajată în sine trebuie schimbată peste tot sau doar anumite surse nu ar mai trebui să o folosească.
• Confirmă dacă lucrul pe care îl înlocuiești este o instanță de bloc din conținut sau o relație către o entitate partajată.
• Revizuiește mai întâi dovezile la nivel de sursă, astfel încât ținta și scope-ul să fie bazate pe un baseline proaspăt.

Unde mergi mai departe #