Change Details

In T324734, we conducted an //initial// review of the Edit Check reference heuristic that T324730 introduced. This task involves the work of making some initial adjustments/improvements to said heuristic to reduce the likelihood that Edit Check would present newcomers with an invitation to include a reference within the edit they're making when a reference might not be necessary (read: refinements to reduce the likelihood of false positives). === Requirements NOTE: the changes below ought to apply to **both** the logic Edit Check uses to determines whether it ought to be activated within a given edit as well as the logic that determines whether the `editcheck-references` tag is appended to an edit. |Objective|Adjustment required |---|--- |Decrease likelihood reference Edit Check appears when people are attempting to publish **copy edits**| Do not trigger Edit Check or append the `editcheck-references` tag when an edit involves content being removed that is adjacent to new content being added |Decrease the likelihood that the reference Edit Check appears when people are attempting to publish changes to **image captions**|Do not consider changes to image captions as warranting Edit Check being activated |Decrease likelihood reference Edit Check appears when people are attempting to publish **edits to tables**|Do not consider changes to tables as warranting Edit Check being activated |Decrease likelihood reference Edit Check appears when people are attempting to publish **edits to lists**|Do not consider changes to lists as warranting Edit Check being activated

In T324734, we conducted an //initial// review of the Edit Check reference heuristic that T324730 introduced. This task involves the work of making some initial adjustments/improvements to said heuristic to reduce the likelihood that Edit Check would present newcomers with an invitation to include a reference within the edit they're making when a reference might not be necessary (read: refinements to reduce the likelihood of false positives). === Requirements NOTE: the changes below ought to apply to **both** the logic Edit Check uses to determines whether it ought to be activated within a given edit as well as the logic that determines whether the `editcheck-references` tag is appended to an edit. |Objective|Adjustment required |---|--- |Decrease likelihood reference Edit Check appears when people are attempting to publish **copy edits**| Do not trigger Edit Check or append the `editcheck-references` tag when an edit involves content being removed that is adjacent to new content being added |Decrease the likelihood that the reference Edit Check appears when people are attempting to publish changes to **image captions**|Do not consider changes to image captions as warranting Edit Check being activated |Decrease likelihood reference Edit Check appears when people are attempting to publish **edits to tables**|Do not consider changes to tables as warranting Edit Check being activated |Decrease likelihood reference Edit Check appears when people are attempting to publish **edits to lists**|Do not consider changes to lists as warranting Edit Check being activated === Approach To meet the `Requirements` described above, we are going to adjust the heuristic such that it only responds to changes to paragraphs that are at the top level of the document. This means any content that is wrapped in any other structure (e.g. tables, lists, and image captions) will be considered outside of Edit Check's scope.

In T324734, we conducted an //initial// review of the Edit Check reference heuristic that T324730 introduced. This task involves the work of making some initial adjustments/improvements to said heuristic to reduce the likelihood that Edit Check would present newcomers with an invitation to include a reference within the edit they're making when a reference might not be necessary (read: refinements to reduce the likelihood of false positives). === Requirements NOTE: the changes below ought to apply to **both** the logic Edit Check uses to determines whether it ought to be activated within a given edit as well as the logic that determines whether the `editcheck-references` tag is appended to an edit. |Objective|Adjustment required |---|--- |Decrease likelihood reference Edit Check appears when people are attempting to publish **copy edits**| Do not trigger Edit Check or append the `editcheck-references` tag when an edit involves content being removed that is adjacent to new content being added |Decrease the likelihood that the reference Edit Check appears when people are attempting to publish changes to **image captions**|Do not consider changes to image captions as warranting Edit Check being activated |Decrease likelihood reference Edit Check appears when people are attempting to publish **edits to tables**|Do not consider changes to tables as warranting Edit Check being activated |Decrease likelihood reference Edit Check appears when people are attempting to publish **edits to lists**|Do not consider changes to lists as warranting Edit Check being activated === Approach To meet the `Requirements` described above, we are going to adjust the heuristic such that it only responds to changes to paragraphs that are at the top level of the document. This means any content that is wrapped in any other structure (e.g. tables, lists, and image captions) will be considered outside of Edit Check's scope.