Difference between revisions of "Editorial Update/Textual Amendments"

From Legislation Community Editorial Wiki
Jump to navigation Jump to search
(Replaced content with "<div id="tna-TextualAmendments"></div> ==Introduction to Textual Amendments== Textual Amendments generally refer to amendments where there is an authority to change the t...")
Tag: Replaced
Line 19: Line 19:
 
==Updating Tables of Contents==
 
==Updating Tables of Contents==
 
Textual amendments to the main table of contents of an item of legislation are not made during editorial update, as the table of contents is dynamically generated. These effects are recorded in TOES, but should have been marked N in the “Applied to database” column with a Note saying 'This amendment not applied to legislation.gov.uk'. The table of contents for this legislation will be dynamically updated when its provisions are revised'. If you encounter an amendment to a table of contents during editorial update, you should check with a <strong>Review Editor</strong> as a TOES correction may be necessary. Note that amendments to tables of contents elsewhere in the legislation other than the main table of contents (e.g. to a table of contents at the top of Part 2 of a Schedule) will have to be applied as textual amendments.
 
Textual amendments to the main table of contents of an item of legislation are not made during editorial update, as the table of contents is dynamically generated. These effects are recorded in TOES, but should have been marked N in the “Applied to database” column with a Note saying 'This amendment not applied to legislation.gov.uk'. The table of contents for this legislation will be dynamically updated when its provisions are revised'. If you encounter an amendment to a table of contents during editorial update, you should check with a <strong>Review Editor</strong> as a TOES correction may be necessary. Note that amendments to tables of contents elsewhere in the legislation other than the main table of contents (e.g. to a table of contents at the top of Part 2 of a Schedule) will have to be applied as textual amendments.
 
==Insertions==
 
 
===Insertion of Words===
 
 
====Carrying out the amendment in XMetaL====
 
 
These instructions assume you have checked out the relevant provision that is to be amended, that you have set up your [[Editorial_Update/Starting_Update_Tasks#Setting_up_your_XMetaL_workspace|XMetaL workspace]], and that you are now ready to carry out the amendment.  For guidance on the steps required to reach this point, see [[Editorial_Update/Starting_Update_Tasks|Starting Update Tasks]].
 
 
<ol><li>In the <strong>amending provision</strong> window:
 
*Read what the amendment is and where in the <strong>amended provision</strong> it is to be made. 
 
*Highlight and copy the word or words (including punctuation) to be inserted. You can right-click and copy or use the standard 'edit' and 'copy' menu options from the menu bar.</li>
 
 
[[File:Insertion of_Words_1.png|link=]]
 
 
<li><p>In the <strong>amended provision</strong> window, place the cursor in the appropriate position in the text (i.e. where the word or words are to be inserted).</p>
 
<p><strong>WARNING:</strong> In secondary legislation, <strong>drafters footnotes</strong> need to be taken into account when deciding where to place the cursor for the insertion of words. Do not place the cursor between a word and a drafters footnote reference that relates to it. See [[Editorial_Update/Textual_Amendments/Insertions/Insertion_of_Words#Scenarios|Scenarios]].</p></li>
 
<li><p>In the <strong>Resource Manager</strong> window single click on the task to highlight it.</p></li>
 
<li>Your next action will be determined by whether the amendment covers the [[Editorial_Update/Textual_Amendments/Insertions/Insertion_of_Words#Whole_extent|whole extent]] or is for a [[Editorial_Update/Textual_Amendments/Insertions/Insertion_of_Words#Limited_extent|limited extent]].</li></ol>
 
 
=====Whole extent=====
 
 
On the menu bar at the top of the page select <strong>Legislation - Textual Amendments -  Addition</strong>.
 
 
[[File:Insertion of_Words_3.png|link=]]
 
 
This will:
 
*Automatically insert the new word or words, bracketed by opening <code><addition></code> and closing <code></addition></code> tags in the <strong>amended provision:</strong>
 
 
[[File:Insertion of_Words_5.png|link=]]
 
 
*Automatically insert the annotation for this amendment at the end of the amended provision:
 
 
 
[[File:Insertion of_Words_4.png|link=]]
 
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
=====Limited extent=====
 
 
On the menu bar at the top of the page select <strong>Legislation - Textual Amendments -  Limited Extent Addition</strong>. In the pop-up 'XMetaL Author Essential', check the Extent entered is correct and click <strong>OK</strong>. This will:
 
*Automatically insert the new word or words, bracketed by opening <code><addition></code> and closing <code></addition></code> tags in the <strong>amended provision</strong>;
 
*Automatically insert the annotation for this amendment at the end of the <strong>amended provision</strong>, including the <strong>limited extent</strong> in brackets after the effect e.g. 'Words in art. 7(2) inserted (<span style = "color:red;">E.W.S.</span>) (6.4.2017) by The Social Security (Restrictions on Amounts for Children and Qualifying Young Persons) Amendment Regulations 2017 (S.I. 2017/376), regs. 1, 4'; and 
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
See more on [[Editorial_Update/Limited_Extent_Amendments|
 
limited extent amendments]].
 
 
<strong>Note:</strong>
 
* Whether whole or limited extent, after the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the <strong>amended provision</strong> window.
 
 
====Checking the amendment in XMetaL====
 
 
<ol><li><p>Once the word or words and have been inserted and the annotation has been automatically generated, check that the annotation is accurate and complete. Carry out any edits if necessary (refer back to the effects spreadsheet if you need to):</p>
 
*Type of Effect is correct;
 
*Punctuation is correct (e.g. no unnecessary spaces);
 
*Date cited is that of the Point of Time you are editing and where applicable the correct <strong>In Force Date Qualification</strong> has been added after the date (check effects spreadsheet for any qualifications). If your amendment is not ‘wholly in force’ and has a different type of <strong>In Force Date Qualification</strong> (for example ‘for specified purposes’), this will be noted in the annotation and you will need to check the annotation to make sure that this has been rendered correctly: for further details on what the annotation should look like see [[Editorial_Update/Annotation_Conventions#Annotations_and_In_Force_Date_Qualifications|Annotations and In Force Date Qualifications]];
 
*If a limited extent amendment, the extent is referenced;
 
*Affected provision is correct;
 
*Affecting provision is correct;
 
*Savings are referenced (where applicable); and
 
*Commencement order is referenced (where applicable).
 
<p>See more detail on the structure of textual amendment annotations in [[Editorial_Update/Annotation_Conventions#F-notes_.28Textual_Amendments.29|Annotation Conventions]].</p></li>
 
 
<li><p>Scroll back up to the where the amendment was made in the <strong>amended provision</strong> and check the inserted wording is positioned correctly. Delete any unnecessary spaces between the existing punctuation and the inserted tags and words, or insert a space if appropriate:</p>
 
</li>
 
 
[[File:Insert_Words_Whole_After.jpg|link=]]
 
 
<p>In this example, the space has been closed up between the closing <code>addition</code> tag and the semi-colon (at the position of the cursor).</p>
 
 
<li><p>Once you are satisfied that the amendment is correct and complete, select <strong>Legislation - Check In</strong> on the menu bar at the top of the page:</p>
 
 
[[File:Check_in.png|link=]]
 
 
</li>
 
 
<li><p>Click <strong>OK</strong> in the pop-up</p>  [[File:Document_is_checked_in_successfully.png|link=]]</li>
 
 
<li><p>Close the <strong>amending provision</strong> window and if you have more update to do, leave XMetaL open and go back to the Editorial Site.</p></li></ol>
 
 
====Checking the amendment on the Editorial Site====
 
 
<ol><li><p>Go back to the <strong>Update Details</strong> page and refresh the page by pressing <code>CTRL</code> and <code>F5</code> at the same time.</p></li>
 
<li><p>Select the <strong>Newly Edited Version</strong> to see a preview of the updated provision. Check that your amendment and annotation commentary are formatted as you would expect.</p></li>
 
<li><p>To check the timeline and see how the provision would look in the context of the whole item of legislation, select the <strong>Preview Legislation</strong> button and check:</p>
 
*You’re satisfied that the amendment is formatted correctly.
 
*The new words are inserted in the right place and have square brackets surrounding them:
 
 
[[File:Insertion of_Words_6.png|link=]]
 
 
*The annotation reference and the text of the annotation are correct:
 
 
[[File:Insertion of_Words_7.png|link=]]
 
 
<p>See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]].</p>
 
 
*The right point in time has been created at provision level to accommodate this amendment:
 
 
[[File:Insertion of_Words_8.png|link=]]
 
 
*The right point in time has been created at the level of the whole item of legislation:
 
 
[[File:Insertion of_Words_9.png|link=]]
 
*You can move between the Points in Time on the timeline correctly.</li>
 
<li><p>Check that the amendment edit status is set to <strong>Edit Complete</strong>. You can also add any notes for the review editor by clicking on the note icon to the right of the edit status. You may need to add a note if there was anything unusual about the amendment that you need to draw to the attention of the review editor.</p></li>
 
<li><p>You can now [[Editorial_Update/Starting_Update_Tasks#Navigating_the_Update_Task|navigate]] to the next part of your update task.</p></li></ol>
 
 
<strong>Video Instructions:</strong> [https://www.youtube.com/watch?v=2wUQMgy8Vok Insertion of words (wholly in force and whole extent)]
 
 
====Insertion of Words Examples====
 
 
=====Taking into account drafters footnotes when inserting words into secondary legislation=====
 
 
https://www.legislation.gov.uk/uksi/2006/606/schedule/3/paragraph/3
 
 
The words "or the Upper Tribunal" were inserted <strong>after</strong> the footnote reference F1, to keep the footnote reference together with the words it relates to.
 
 
{| class="wikitable" align="right"
 
|<strong>Back to</strong> [[Editorial_Update/Textual_Amendments#tna-TextualAmendments|Top]]
 
|}
 
 
===Insertion of Sub-provisions===
 
 
====Carrying out the amendment in XMetaL====
 
 
If you need to insert a <strong>whole provision</strong>, follow the instructions for [[Editorial_Update/Textual_Amendments/Insertions/Higher_Level_Insertions|Higher Level Insertions]]
 
 
<Strong>Note:</strong> These instructions assume you have checked out the relevant provision that is to be amended, that you have set up your [[Editorial_Update/Starting_Update_Tasks#Setting_up_your_XMetaL_workspace|XMetaL workspace]], and that you are now ready to carry out the amendment.  For guidance on the steps required to reach this point, see [[Editorial_Update/Starting_Update_Tasks|Starting Update Tasks]].
 
 
<ol><li>In the <strong>amending provision</strong> window:
 
*Read what the amendment is and where in the <strong>amended provision</strong> it is to be made. 
 
*Select the appropriate <code><ukl:P#></code> tag to highlight and copy the sub-provision to be inserted:</li>
 
 
<blockquote>Sub-Provision: <code><ukl:P2></code>
 
Sub-sub-provision: <code><ukl:P3></code><br>
 
<br><strong>Note:</strong> you can also select the <code><BlockAmendment></code> tag, if there is one.</blockquote>
 
 
You can right-click and copy or use the standard ‘edit’ and ‘copy’ menu options from the menu bar.
 
 
[[File:Insertion_of_sub-provision_1.png|link=]]
 
 
 
<li>In the <strong>amended provision</strong>, place the cursor after the closing <code>ukl:P2</code> or <code>ukl:P3</code> tag of the sub-provision that precedes the one you are inserting.</li> 
 
<li>Single click on the task to highlight it in the <strong>Resource Manager</strong> window.</li>
 
 
<li>Your next action will be determined by whether the amendment covers the [[Editorial_Update/Textual_Amendments/Insertions/Insertion_of_Sub-Provisions#Whole_extent|whole extent]] or is for a [[Editorial_Update/Textual_Amendments/Insertions/Insertion_of_Sub-Provisions#Limited_extent|limited extent]].</li></ol>
 
 
=====Whole extent=====
 
 
On the menu bar at the top of the page select <strong>Legislation - Textual Amendments -  Addition</strong>:
 
 
[[File:Insertion_of_sub-provision_2.png|link=]]
 
 
This will:
 
*Automatically insert the new sub-provision, bracketed by opening <code><addition></code> and closing <code></addition></code> tags in the <strong>amended provision:</strong>
 
 
[[File:Insertion_of_sub-provision_4.png|link=]]
 
 
*Automatically insert the annotation for this amendment at the end of the <strong>amended provision:</strong>
 
 
[[File:Insertion_of_sub-provision_3.png|link=]]
 
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
=====Limited extent=====
 
 
On the menu bar at the top of the page select <strong>Legislation - Textual Amendments -  Limited Extent Addition</strong>. In the pop-up 'XMetaL Author Essential', check the Extent entered is correct and click <strong>OK</strong>; this will:
 
*Automatically insert the new sub-provision, bracketed by opening <code><addition></code> and closing <code></addition></code> tags in the <strong>amended provision</strong>;
 
*Automatically insert the annotation for this amendment at the end of the <strong>amended provision</strong>, including the <strong>limited extent</strong> in brackets after the effect; and
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
<strong>Note:</strong>
 
* Whether whole or limited extent, after the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the <strong>amended provision</strong> window.
 
 
See more on [[Editorial_Update/Limited_Extent_Amendments|
 
limited extent amendments]].
 
 
====Checking the amendment in XMetaL====
 
 
<ol><li>Once the sub-provision has been inserted and the auto-annotation has been generated, check that the annotation is accurate and complete. Carry out any edits if necessary (refer back to the effects spreadsheet if you need to):
 
*Type of Effect is correct;
 
*Punctuation is correct (e.g. no unnecessary spaces);
 
*Date cited is that of the Point of Time you are editing and where applicable the correct <strong>In Force Date Qualification</strong> has been added after the date (check effects spreadsheet for any qualifications). If your amendment is not ‘wholly in force’ and has a different type of <strong>In Force Date Qualification</strong> (for example ‘for specified purposes’), this will be noted in the annotation and you will need to check the annotation to make sure that this has been rendered correctly: for further details on what the annotation should look like see [[Editorial_Update/Annotation_Conventions#Annotations_and_In_Force_Date_Qualifications|Annotations and In Force Date Qualifications]];
 
*If a limited extent amendment, the extent is referenced;
 
*Affected provision is correct;
 
*Affecting provision is correct;
 
*Savings are referenced (where applicable); and
 
*Commencement order is referenced (where applicable).
 
See more detail on the structure of textual amendment annotations in [[Editorial_Update/Annotation_Conventions#F-notes_.28Textual_Amendments.29|Annotation Conventions]].</li>
 
 
<li>Scroll back up to the where the amendment was made in the <strong>amended provision</strong> and check the inserted sub-provision is positioned correctly.
 
</li>
 
 
<li>Once you are satisfied that the amendment is correct and complete, select <strong>Legislation - Check In</strong> on the menu bar at the top of the page:
 
<br>
 
<br>
 
[[File:Check_in.png|link=]]
 
<br>
 
<br>
 
</li>
 
<br>
 
<li>Click <strong>OK</strong> in the pop-up  [[File:Document_is_checked_in_successfully.png|link=]]</li>
 
<br>
 
<li>Close the <strong>amending provision</strong> window and if you have more update to do, leave XMetaL open and go back to the Editorial Site.</li></ol>
 
 
====Checking the amendment on the Editorial Site====
 
 
<ol><li>Go back to the <strong>Update Details</strong> page and refresh the page by pressing <code>CTRL</code> and <code>F5</code> at the same time.</li>
 
<li>Select the <strong>Newly Edited Version</strong> to see a preview of the updated provision. Check that your amendment and annotation commentary are formatted as you would expect.</li>
 
<li>To check the timeline and see how the provision would look in the context of the whole item of legislation, select the <strong>Preview Legislation</strong> button and check:
 
*You’re satisfied that the amendment is formatted correctly.
 
*The new sub-provision is inserted in the right place and has square brackets surrounding it.
 
*The annotation reference and the text of the annotation are correct:
 
 
[[File:Insertion_of_sub-provision_6.png|link=]]
 
<br>
 
 
See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]].
 
 
 
*The right point in time has been created at provision level to accommodate this amendment:
 
 
 
[[File:Insertion_of_sub-provision_5.png|link=]]
 
 
 
*The right point in time has been created at the level of the whole item of legislation:
 
 
 
[[File:Insertion_of_sub-provision_7.png|link=]]
 
 
 
*You can move between the Points in Time on the timeline correctly.</li>
 
 
<li>Check that the amendment edit status is set to <strong>Edit Complete</strong>. You can also add any notes for the review editor by clicking on the note icon to the right of the edit status. You may need to add a note if there was anything unusual about the amendment that you need to draw to the attention of the review editor.</li>
 
<li>You can now [[Editorial_Update/Starting_Update_Tasks#Navigating_the_Update_Task|navigate]] to the next part of your update task.</li></ol>
 
 
<Strong>Video Instructions:</strong> [https://www.youtube.com/watch?v=HZZBQ_OI9bw Insertion of a sub-provision (wholly in force and whole extent)]
 
 
{| class="wikitable" align="right"
 
|<strong>Back to</strong> [[Editorial_Update/Textual_Amendments#tna-TextualAmendments|Top]]
 
|}
 
 
===Higher Level Insertions===
 
 
====Carrying out the amendment in XMetaL====
 
 
<Strong>Note:</strong> These instructions assume you have checked out the relevant parent-level that is to be amended, that you have set up your [[Editorial_Update/Starting_Update_Tasks#Setting_up_your_XMetaL_workspace|XMetaL workspace]], and that you are now ready to carry out the amendment.  For guidance on the steps required to reach this point, see [[Editorial_Update/Starting_Update_Tasks|Starting Update Tasks]].
 
 
<ol><li>In the <strong>amending provision</strong> window:
 
*Read what the amendment is and where in the <strong>amended provision</strong> it is to be made. 
 
*In the <strong>amending provision</strong> highlight and copy the provision that you need to insert by selecting the appropriate opening tag. For example:
 
**<code>ukl:P1</code> (select from <code>ukl:P1group</code> if the provision has a title) for a provision
 
**<code>ukl:Part</code> for a Part 
 
**<code>ukl:Chapter</code> for a Chapter
 
**<code>ukl:Schedule</code> for a Schedule 
 
 
You can also select the <code>BlockAmendment</code> tag to select the whole block of data to be inserted. You can right-click and copy or use the standard 'edit' and 'copy' menu options from the menu bar, e.g.
 
<br/>
 
<br/>
 
[[File:Insertion_of_Part_amending_provision.png|link=]]
 
<br/>
 
<br/>
 
 
<li>In the <strong>amended provision</strong>, scroll to find the provision that the new provision will follow and place the cursor at the end of that provision (i.e. after the closing <code>/ukl:P1group</code>, <code>/ukl:Part</code>, <code>/ukl:Chapter</code>, or <code>/ukl:Schedule</code> tag) and before the opening tags of the next provision. If in doubt you can use the <strong>Element list</strong> to check which tags are valid where your cursor is currently positioned. For example, the cursor is positioned between the closing <code>/ukl:Part</code> tag of Part 8 and the opening <code>ukl:Part</code> tag of Part 9 when Part 8A is to be inserted:</li>
 
<br/>
 
[[File:Insertion_of_Part_amended_provision.png|link=]]
 
<br/>
 
 
 
<li>Single click on the task to highlight it in the <strong>Resource Manager</strong> window.</li>
 
[[File:Insertion_of_Part_RM.png|link=]]
 
 
<li>Your next action will be determined by whether the amendment covers the [[Editorial_Update/Textual_Amendments/Insertions/Higher_Level_Insertions#Whole_extent|whole extent]] or is for a [[Editorial_Update/Textual_Amendments/Insertions/Higher_Level_Insertions#Limited_extent|limited extent]].</li></ol>
 
 
=====Whole extent=====
 
 
On the menu bar at the top of the page select <strong>Legislation - Textual Amendments -  Addition</strong>.
 
<br>
 
<br>
 
[[File:Insertion_of_Part_menu_whole_extent.png|link=]]
 
<br>
 
<br>
 
This will:
 
*Automatically insert the new provision/Part/Chapter/Schedule, etc. bracketed by opening <code><addition></code> and closing <code></addition></code> tags in the <strong>amended provision</strong>;
 
*Automatically insert the annotation for this amendment at the end of the <strong>amended provision</strong>; and
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
After the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the <strong>amended provision</strong> window:
 
 
[[File:Insertion_of_Part_XMetaL_view_after_amendment.png|link=]]
 
 
=====Limited extent=====
 
 
On the menu bar at the top of the page select <strong>Legislation - Textual Amendments -  Limited Extent Addition</strong>. In the pop-up 'XMetaL Author Essential', check the Extent entered is correct and click <strong>OK</strong>; this will:
 
*Automatically insert the new provision/Part/Chapter/Schedule, etc. bracketed by opening <code><addition></code> and closing <code></addition></code> tags in the <strong>amended provision</strong>;
 
*Automatically insert the annotation for this amendment at the end of the <strong>amended provision</strong>, including the <strong>limited extent</strong> in brackets after the effect; and
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
See more on [[Editorial_Update/Limited_Extent_Amendments|
 
limited extent amendments]].
 
 
After the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the <strong>amended provision</strong> window.
 
 
====Checking the amendment in XMetaL====
 
 
<ol><li>Once the provision has been inserted and the annotation has been automatically generated, check that the annotation is accurate and complete. Carry out any edits if necessary (refer back to the effects spreadsheet if you need to):
 
*Type of Effect is correct;
 
*Punctuation is correct (e.g. no unnecessary spaces);
 
*Date cited is that of the Point of Time you are editing and where applicable the correct <strong>In Force Date Qualification</strong> has been added after the date (check effects spreadsheet for any qualifications). If your amendment is not ‘wholly in force’ and has a different type of <strong>In Force Date Qualification</strong> (for example ‘for specified purposes’), this will be noted in the annotation and you will need to check the annotation to make sure that this has been rendered correctly: for further details on what the annotation should look like see [[Editorial_Update/Annotation_Conventions#Annotations_and_In_Force_Date_Qualifications|Annotations and In Force Date Qualifications]];
 
*If a limited extent amendment, the extent is referenced;
 
*Affected provision is correct;
 
*Affecting provision is correct;
 
*Savings are referenced (where applicable);
 
*Commencement order is referenced (where applicable).
 
See more detail on the structure of textual amendment annotations in [[Editorial_Update/Annotation_Conventions#F-notes_.28Textual_Amendments.29|Annotation Conventions]].</li>
 
 
<li>Scroll back up to the where the amendment was made in the <strong>amended provision</strong> and check the inserted provision is positioned correctly and that the tagging is correct, e.g. sometimes the title or number may be incorrectly tagged - if you think this may be the case, check how it has been tagged throughout the rest of the amended document and if necessary correct it.</li>
 
 
<li>Once you are satisfied that the amendment is correct and complete, select <strong>Legislation - Check In</strong> on the menu bar at the top of the page:
 
<br>
 
<br>
 
[[File:Check_in.png|link=]]
 
<br>
 
<br>
 
</li>
 
<br>
 
<li>Click <strong>OK</strong> in the pop-up  [[File:Document_is_checked_in_successfully.png|link=]]</li>
 
<br>
 
<li>Close the <strong>amending provision</strong> window and if you have more update to do, leave XMetaL open and go back to the Editorial Site.</li></ol>
 
 
====Checking the amendment on the Editorial Site====
 
 
<ol><li>Go back to the <strong>Update Details</strong> page and refresh the page by pressing <code>CTRL</code> and <code>F5</code> at the same time.</li>
 
<li>To check the timeline and see how the provision would look in the context of the whole item of legislation, select the <strong>Preview Legislation</strong> button and check:
 
 
*That the provision/Part/Chapter/Schedule, etc. appears in the correct place in the Table of Contents;
 
*Open the new provision/Part/Chapter/Schedule, etc. on its own and check that there are opening and closing brackets around the text with an accompanying F-note reference appearing immediately after the opening amendment bracket. The version history should show one Point in Time as at the date of the insertion;
 
*Open the parent level and view your amendment to check you’re satisfied that the amendment has formatted correctly, that it is in the right place and that it has square brackets around it and the annotation reference and annotation text are correct. See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]]; and
 
*The version history should include a new Point in Time for the newly inserted provision and you should check that you can move between the Points in Time on the timeline correctly.
 
 
<li>Check that the amendment edit status is set to <strong>Edit Complete</strong>. You can also add any notes for the review editor by clicking on the note icon to the right of the edit status. You may need to add a note if there was anything unusual about the amendment that you need to draw to the attention of the review editor.</li>
 
<li>You can now [[Editorial_Update/Starting_Update_Tasks#Navigating_the_Update_Task|navigate]] to the next part of your update task.</li></ol>
 
 
 
<strong>Video Instructions:</strong> [https://www.youtube.com/watch?v=sTD6toP-63A Insertion of a section (wholly in force and whole extent)]
 
 
====Higher Level Insertions Examples====
 
 
=====Insertion of a provision that was previously repealed=====
 
 
If a provision is repealed or revoked and then a new provision with the same number is inserted, this should be carried out as a [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Provisions_and_Sub-Provisions|substitution]] of the existing provision, but the annotation should still read 'inserted' and 'by':
 
 
See http://www.legislation.gov.uk/uksi/2012/2996/schedule/4/paragraph/76/2016-04-01 (provision was omitted at previous PiT 1/4/2015 and is now inserted again).
 
 
=====Revival of a previously repealed/revoked provision=====
 
 
If a repealed/revoked provision is revived, we would have to copy the xml from the version previous to the dotty lined version and make a new version from the date it got revived.  This would need to be done by a <strong>Review Editor</strong> using the correction tool.
 
 
=====Multiple insertions of provisions with the same number=====
 
 
We do get genuine instances (admittedly usually resulting from drafting errors), where two provisions with the same number get inserted.  We should raise a [[Editorial_Principles/Errors_in_Legislation_-_Lex_Errors | lex error]] for these situations.  In the meantime we have to account for it in update and we should refer this to TSO to look at the URLs of each provision for us to make sure they work as expected from the ToC.
 
 
{| class="wikitable" align="right"
 
|<strong>Back to</strong> [[Editorial_Update/Textual_Amendments#tna-TextualAmendments|Top]]
 
|}
 
 
==Substitutions==
 
 
===Substitution of Words===
 
 
====Carrying out the amendment in XMetaL====
 
 
<Strong>Note:</strong> These instructions assume you have checked out the relevant provision that is to be amended, that you have set up your [[Editorial_Update/Starting_Update_Tasks#Setting_up_your_XMetaL_workspace|XMetaL workspace]], and that you are now ready to carry out the amendment.  For guidance on the steps required to reach this point, see [[Editorial_Update/Starting_Update_Tasks|Starting Update Tasks]].
 
 
<ol><li>In the <strong>amending provision</strong> window:
 
*Read what the amendment is and where in the <strong>amended provision</strong> it is to be made. 
 
*Highlight and copy the word or words (including punctuation) to be substituted. You can right-click and copy or use the standard ‘edit’ and ‘copy’ menu options from the menu bar.</li>
 
<li>In the <strong>amended provision</strong> window, highlight the existing text that is to be substituted.</li>
 
<li>In the <strong>Resource Manager</strong> window single click on the task to highlight it.</li>
 
<li>Your next action will be determined by whether the amendment covers the [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Words#Whole_extent|whole extent]] or is for a [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Words#Limited_extent|limited extent]], or whether it needs to be a [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Words#Retained_Text_Substitutions|retained text substitution]] (e.g. In In Force Date Qualification 'for specified purposes').</li></ol>
 
 
=====Whole extent=====
 
 
On the menu bar at the top of the page select <strong>Legislation - Textual Amendments -  Substitution</strong>. This will:
 
*Automatically substitute the new word or words for the existing text, bracketed by opening <code><substitution></code> and closing <code></substitution></code> tags in the <strong>amended provision</strong>;
 
*Automatically insert the annotation for this amendment at the end of the amended provision e.g. ‘Words in sch. 1 substituted (28.11.2018) by The Budget (Scotland) Act 2018 Amendment Regulations 2018 (S.S.I. 2018/363), regs. 1(1), 3(2)(d)(i)’; and
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
=====Limited extent=====
 
 
On the menu bar at the top of the page select <strong>Legislation - Textual Amendments -  Limited Extent Substitution</strong>. In the pop-up <strong>XMetaL Author Essential</strong>, check the Extent entered is correct and click <strong>OK</strong>; this will:
 
 
*In the <strong>amended provision</strong>, retain the existing word or words, bracketed by opening <code><repeal></code> and closing <code></repeal></code> tags, and next to this insert the new word or words, bracketed by opening <code><addition></code> and closing <code></addition></code> tags.
 
*Automatically insert the annotation for this amendment at the end of the <strong>amended provision</strong>, including the <strong>limited extent</strong> in brackets after the effect e.g. 'Words in Sch. 1 para. 6 substituted (<span style = "color:red;">E.W.</span>) (1.1.2017) by The Environmental Permitting (England and Wales) Regulations 2016 (S.I. 2016/1154), reg. 1(1), Sch. 29 Pt. 1 para. 20(b) (with regs. 1(3), 77-79, Sch. 4)'; and 
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
See an [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Words#Limited_Extent_Substitution_of_Words|example]] of a limited extent substitution of words and further reading on[[Editorial_Update/Limited_Extent_Amendments|
 
limited extent amendments]].
 
 
=====Retained text substitutions=====
 
 
If your amendment is not ‘wholly in force’ and has a different type of <strong>In Force Date Qualification</strong> (for example ‘for specified purposes’), you may need to carry out a <strong>retained text</strong> substitution to make sure that the existing word or words are retained alongside the newly substituted word or words. Check with a <strong>Review Editor</strong> if you are not sure.
 
 
On the menu bar at the top of the page click <strong>Legislation - Textual Amendments - Substitution Retain Text</strong>; this will
 
 
*Retain the existing word or words, bracketed by opening <code><repeal></code> and closing <code></repeal></code> tags, and insert the new wording, bracketed by opening <code><addition></code> and closing <code></addition></code> tags.
 
*Automatically insert the annotation for this amendment at the end of the <strong>amended provision</strong>, including the <strong>In Force Date Qualification</strong> e.g. 'Words in Sch. 7 para. 5(7) substituted (31.1.2017 <span style = "color:red;">for specified purposes</span>) by Policing and Crime Act 2017 (c. 3), s. 183(1)(5)(e), Sch. 2 para. 122(3)'; and 
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
See an [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Words#Substitution_of_Words_for_Specified_Purposes|example]] of a substitution of words for specified purposes.
 
 
 
<strong>Note:</strong>
 
* Whether whole, limited extent or retained text, after the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the <strong>amended provision</strong> window.
 
*When you are substituting words, any commentary reference included in the text you highlight will be removed automatically on substitution and if this commentary reference relates to a single annotation that annotation will also be removed automatically on check-in.
 
*Occasionally there may be multiple substitutions of the same words throughout a provision.  As long as the same task in the <strong>Resource Manager</strong> window is highlighted on each occasion, it is possible to carry out the same substitution of words and generate the same commentary reference (linking to the same annotation) each time, without any unnecessary new footnote references or annotations also being created.
 
 
====Checking the amendment in XMetaL====
 
 
<ol><li>Once the word or words and have been substituted (or text retained and new text inserted alongside it), and the annotation has been automatically generated, check that the annotation is accurate and complete. Carry out any edits if necessary (refer back to the effects spreadsheet if you need to):
 
*Type of Effect is correct;
 
*Punctuation is correct (e.g. no unnecessary spaces);
 
*Date cited is that of the Point of Time you are editing and where applicable the correct In Force Date Qualification has been added after the date (check effects spreadsheet for any qualifications). If your amendment is not ‘wholly in force’ and has a different type of <strong>In Force Date Qualification</strong> (for example ‘for specified purposes’), this will be noted in the annotation and you will need to check the annotation to make sure that this has been rendered correctly: for further details on what the annotation should look like see [[Editorial_Update/Annotation_Conventions#Annotations_and_In_Force_Date_Qualifications|Annotations and In Force Date Qualifications]];
 
*If a limited extent amendment, the extent is referenced;
 
*Affected provision is correct;
 
*Affecting provision is correct;
 
*Savings are referenced (where applicable); and
 
*Commencement order is referenced (where applicable).
 
See more detail on the structure of textual amendment annotations in [[Editorial_Update/Annotation_Conventions#F-notes_.28Textual_Amendments.29|Annotation Conventions]].</li>
 
 
<li>Scroll back up to the where the amendment was made in the <strong>amended provision</strong> and check that the substituted wording is positioned correctly and has opening and closing brackets around it. For any retained and inserted text check that this is positioned correctly and surrounded by opening and closing brackets. Delete any unnecessary spaces between the existing punctuation and the substituted tags and words, or insert a space if appropriate.
 
</li>
 
 
<strong>Before</strong>
 
[[File:Substitution of Words Before -WE.png|link=]]
 
 
<strong>After</strong>
 
[[File:Substitution of Words After -WE.png|link=]]
 
 
See on the published site [http://www.legislation.gov.uk/ukpga/1988/41/schedule/8/paragraph/10 1988 c. 41 sch. 8 para. 10]
 
 
 
<li>Once you are satisfied that the amendment is correct and complete, select <strong>Legislation - Check In</strong> on the menu bar at the top of the page:
 
<br>
 
<br>
 
[[File:Check_in.png|link=]]
 
<br>
 
<br>
 
</li>
 
<br>
 
<li>Click <strong>OK</strong> in the pop-up  [[File:Document_is_checked_in_successfully.png|link=]]</li>
 
<br>
 
<li>Close the <strong>amending provision</strong> window and if you have more update to do, leave XMetaL open and go back to the Editorial Site.</li></ol>
 
 
====Checking the amendment on the Editorial Site====
 
 
<ol><li>Go back to the <strong>Update Details</strong> page and refresh the page by pressing <code>CTRL</code> and <code>F5</code> at the same time.</li>
 
<li>Select the <strong>Newly Edited Version</strong> to see a preview of the updated provision. Check that your amendment and annotation commentary are formatted as you would expect.</li>
 
<li>To check the timeline and see how the provision would look in the context of the whole item of legislation, select the <strong>Preview Legislation</strong> button and check:
 
*You’re satisfied that the amendment is formatted correctly;
 
*Check that the newly substituted words are in the right place and have square brackets surrounding them;
 
*The annotation reference and the text of the annotation are correct. The annotation reference will be located just inside the opening square bracket of the substituted text (or for limited extent or specified purposes, the retained text and inserted text, which will be side by side). See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]];
 
*The right point in time has been created at provision level to accommodate this amendment;
 
*The right point in time has been created at the level of the whole item of legislation;
 
*You can move between the Points in Time on the timeline correctly.</li>
 
<li>Check that the amendment edit status is set to <strong>Edit Complete</strong>. You can also add any notes for the review editor by clicking on the note icon to the right of the edit status. You may need to add a note if there was anything unusual about the amendment that you need to draw to the attention of the review editor.</li>
 
<li>You can now [[Editorial_Update/Starting_Update_Tasks#Navigating_the_Update_Task|navigate]] to the next part of your update task.</li></ol>
 
 
====Substitution of Words Examples====
 
 
=====Limited Extent Substitution of Words=====
 
 
See substitution of words (for E.W.S only) with retained text in S.I. 2015/310, [http://www.legislation.gov.uk/uksi/2015/310/regulation/31/2018-02-22 reg. 31] (annotation reference F1).
 
 
<strong>Note:</strong> The first set of words is the retained text and the second set of words is the substituted text for E.W.S. only.
 
 
=====Substitution of Words for Specified Purposes=====
 
 
See retained text substitution of words in 2014 c. 12, [http://www.legislation.gov.uk/ukpga/2014/12/schedule/8/paragraph/3/2017-01-31 Sch. 8 para 3(2)].
 
 
<strong>Note:</strong> The first set of words in brackets is the retained text and the second set of words is the substituted text (for specified purposes).
 
 
[[File:Substitution_of_Words_1a.png|link=]]
 
 
<strong>Annotation:</strong>
 
 
<blockquote>Words in Sch. 8 para. 3(2) substituted (31.1.2017 for specified purposes) by Policing and Crime Act 2017 (c. 3), ss. 163(4)(a), 183(1)(5)(e)</blockquote>
 
 
=====Multiple substitutions affecting the same set of words in the same provision at one PiT=====
 
 
Two amendments are made to the same set of words in 2006 c.14, s. 57(3)(a)(4) by 2012 c. 7, [http://www.legislation.gov.uk/ukpga/2012/7/section/172/2013-04-01#section-172 s. 172(4)(5)(b)]  and [http://www.legislation.gov.uk/ukpga/2012/7/section/173/2013-04-01#section-173 s. 173(2)(a)(i)(iii)] on 1/4/2013.
 
 
<strong>Commencement information:</strong> s. 172(4)(5)(b) comes into force immediately before the coming into force of section 173 (by S.I. 2013/671, [http://www.legislation.gov.uk/uksi/2013/671/article/2/2 art. 2(2)]) and
 
s. 173(2)(a)(i)(iii) comes into force on 1/4/2013 (by S.I. 2013/671, [http://www.legislation.gov.uk/uksi/2013/671/article/2/3 art. 2(3)])
 
 
The amendments by s. 172(4)(5)(b) have to be done first, otherwise some or all of the amendments by s. 173 will not work. 
 
 
S. 172(4)(5)(b) states:
 
 
<blockquote>“(4) In subsection (3)(a) of that section, for “section 54(3)” substitute “<span style = "color:red;">section 54(4)</span>”.
 
 
(5) In subsection (4) of that section—
 
 
 
 
(b) for “section 54(4)(a) to (c)” substitute “<span style = "color:red;">section 54(4)(a) or (c)</span>”.”</blockquote>
 
 
And then s. 173(2)(a)(i)(iii) substitutes sets of words including those substituted words:
 
 
<blockquote>“(2) …
 
 
(a) in section 57 of that Act (as amended by section 172 of this Act)—
 
 
(i) in subsection (3)(a), for “the persons mentioned in <span style = "color:red;">section 54(4)</span>” substitute “another NHS foundation trust, an NHS trust established under section 25 or the Secretary of State”,
 
 
 
 
(iii) in subsection (4), for “any of the bodies mentioned in <span style = "color:red;">section 54(4)(a) or (c)</span>” substitute “another NHS foundation trust or an NHS trust established under section 25””</blockquote>
 
 
But “immediately” means without anything coming in between, so the drafter really wants to get to the amendments by s. 173 straight away but they have to do the amendments by s. 172(4)(5)(b) first.  Therefore, mark the amendments by s. 172(4)(5)(b) as applied and add a note for the reviewer explaining why they’re invisible.  Then apply the amendments by s. 173(2)(a)(i)(iii) and change the F-notes for the amendments by s. 173(2)(a)(i)(iii) to mention s. 172(4) and (5)(b) (as appropriate) and S.I. 2013/671, art. 2(2).
 
 
<strong>Final result:</strong> See F8 and F11 in s. 57(3)(4):
 
http://www.legislation.gov.uk/ukpga/2006/41/section/57/2013-04-01
 
 
 
{| class="wikitable" align="right"
 
|<strong>Back to</strong> [[Editorial_Update/Textual_Amendments#tna-TextualAmendments|Top]]
 
|}
 
 
===Substitution of Provisions and Sub-provisions===
 
 
====Carrying out the amendment in XMetaL====
 
 
If your substitution involves [[Editorial_Update/Textual_Amendments/Substitutions/Higher_Level_Substitutions#Unequal_substitutions_of_whole_provisions|unequal substitution of whole provisions]], you should follow the instructions in <strong>Higher Level Substitutions</strong>, as you will need to have checked out the parent level of the provision.
 
 
<Strong>Note:</strong> These instructions assume you have checked out the relevant provision that is to be amended, that you have set up your [[Editorial_Update/Starting_Update_Tasks#Setting_up_your_XMetaL_workspace|XMetaL workspace]], and that you are now ready to carry out the amendment.  For guidance on the steps required to reach this point, see [[Editorial_Update/Starting_Update_Tasks|Starting Update Tasks]].
 
 
<ol><li> In the <strong>amended provision</strong> window:
 
*Check if there are any annotation references relating to the provision or sub-provision to be substituted appearing in front of the provision number and if so, check if the annotation reference is for a textual amendment  (F-note) or a non-textual amendment (C-note):
 
 
<strong>C-notes:</strong> When a whole provision or sub-provision is substituted, the existing C-notes do not necessarily become redundant. If the affecting legislation giving rise to the C-note has been repealed or revoked then they should be removed. However, please do not remove them without consulting a <strong>Review Editor</strong>.
 
<br>
 
<br>
 
<strong>F-notes</strong>: Where they exist these will usually need removing. Read the annotations first to ensure they will no longer apply after the substitution is completed. If in doubt seek advice from a <strong>Review Editor</strong>.</li>
 
 
<li>In the <strong>amending provision</strong> window:
 
*Read what the amendment is and where in the <strong>amended provision</strong> it is to be made.
 
 
 
<strong>Note: </strong>If the title is also substituted as part of the substitution, this will need to be done separately. First carry out the substitution for the provision and then substitute the new title for the old in the <code>ukl:title</code> tags (you can copy and paste). You will then need to drag the opening <code>substitution</code> tag to the beginning of the title.
 
 
 
*Select the appropriate <code><ukl:P#para></code> tag to highlight and copy the provision/sub-provision to be substituted:
 
**Provision: <code><ukl:P1para></code>
 
**Sub-Provision: <code><ukl:P2para></code>
 
**Sub-sub-provision: <code><ukl:P3para></code>
 
 
 
<strong>Note:</strong> ensure all the text including punctuation within the <code><ukl:P#para></code> tags is highlighted <strong>BUT NOT</strong> the provision number (enclosed in <code><ukl:Pnumber></code> tags):
 
<br/>
 
<br/>
 
 
[[File:Substitution_of_Provision_image 1.jpg|link=]]
 
<br/>
 
<br/>
 
 
You can right-click and copy or use the standard ‘edit’ and ‘copy’ menu options from the menu bar.</li>
 
 
<li>In the <strong>amended provision</strong>, highlight the relevant <code><ukl:P1para></code>, <code><ukl:P2para></code> or <code><ukl:P3para></code> tag for the provision or sub-provision that is to be substituted.</li> 
 
<li>Single click on the task to highlight it in the <strong>Resource Manager</strong> window.</li>
 
 
<li>Your next action will be determined by whether the amendment covers the [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Provisions_and_Sub-Provisions#Whole_extent|whole extent]], is for a [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Provisions_and_Sub-Provisions#Limited_extent|limited extent]], or whether it needs to be a retained text substitution (e.g. In In Force Date Qualification 'for specified purposes').</li></ol>
 
 
=====Whole extent=====
 
 
On the menu bar at the top of the page select <strong>Legislation - Textual Amendments -  Substitution</strong>. This will:
 
*Automatically substitute the provision/sub-provision, bracketed by opening <code><substitution></code> and closing <code></substitution></code> tags in the <strong>amended provision</strong>;
 
*Automatically insert the annotation for this amendment at the end of the <strong>amended provision</strong> e.g. e.g.  S. 5(3) substituted (1.3.2004) by Health and Education Act 2003 (c. 90), s. 130, Sch. 18 para. 8; and
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
=====Limited extent=====
 
 
On the menu bar at the top of the page select <strong>Legislation - Textual Amendments -  Limited Extent Substitution</strong>. In the pop-up 'XMetaL Author Essential', check the Extent entered is correct and click <strong>OK</strong>; this will:
 
*Retain the existing provision or sub-provision, bracketed by opening <code><repeal></code> and closing <code></repeal></code> tags, and insert after this the substituted provision or sub-provision, bracketed by opening <code><addition></code> and closing <code></addition></code> tags;
 
*Automatically insert the annotation for this amendment at the end of the <strong>amended provision</strong>, including the <strong>limited extent</strong> in brackets after the effect; and
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
See more on [[Editorial_Update/Limited_Extent_Amendments|
 
limited extent amendments]].
 
 
=====Retained text substitutions=====
 
 
If your amendment is not ‘wholly in force’ and has a different type of <strong>In Force Date Qualification</strong> (for example ‘for specified purposes’), you may need to carry out a <strong>retained text</strong> substitution to make sure that the existing provision/sub-provision is retained alongside the newly substituted provision/sub-provision. Check with a <strong>Review Editor</strong> if you are not sure.
 
 
On the menu bar at the top of the page click <strong>Legislation - Textual Amendments - Substitution Retain Text</strong>; this will
 
 
*Retain the existing provision or sub-provision, bracketed by opening <code><repeal></code> and closing <code></repeal></code> tags, and insert after this the substituted provision or sub-provision, bracketed by opening <code><addition></code> and closing <code></addition></code> tags.
 
*Automatically insert the annotation for this amendment at the end of the <strong>amended provision</strong>, including the <strong>In Force Date Qualification</strong>; and 
 
*Generate a green tick next to the task in the <strong>Resource Manager</strong> window to show that it has been completed.
 
 
 
<strong>Note:</strong>
 
* Whether whole, limited extent or retained text, after the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the <strong>amended provision</strong> window.
 
 
====Checking the amendment in XMetaL====
 
 
<ol><li>Once the provision/sub-provision has been substituted and the auto-annotation has been generated, check that the annotation is accurate and complete. Carry out any edits if necessary (refer back to the effects spreadsheet if you need to):
 
*Type of Effect is correct;
 
*Punctuation is correct (e.g. no unnecessary spaces);
 
*Date cited is that of the Point of Time you are editing and where applicable the correct <strong>In Force Date Qualification</strong> has been added after the date (check effects spreadsheet for any qualifications). If your amendment is not ‘wholly in force’ and has a different type of <strong>In Force Date Qualification</strong> (for example ‘for specified purposes’), this will be noted in the annotation and you will need to check the annotation to make sure that this has been rendered correctly: for further details on what the annotation should look like see [[Editorial_Update/Annotation_Conventions#Annotations_and_In_Force_Date_Qualifications|Annotations and In Force Date Qualifications]];
 
*If a limited extent amendment, the extent is referenced;
 
*Affected provision is correct;
 
*Affecting provision is correct
 
*Savings are referenced (where applicable); and
 
*Commencement order is referenced (where applicable).
 
See more detail on the structure of textual amendment annotations in [[Editorial_Update/Annotation_Conventions#F-notes_.28Textual_Amendments.29|Annotation Conventions]].</li>
 
 
<li>Scroll back up to the where the amendment was made in the <strong>amended provision</strong> and check the substituted provision/sub-provision is positioned correctly.</li>
 
 
<strong>Note:</strong> The opening bracket for the substitution will automatically be positioned in the correct location before the provision or sub-provision number after you have checked the <strong>amended provision</strong> back in. However, if your substitution also included a title, you need to adjust the position of the opening bracket to include the title by moving (click and drag) the opening <code>ukl:substitution</code> tag, e.g.
 
 
Original location of <code>ukl:substitution</code> tag:
 
[[File:Substitution_of_provision_3.png|link=]]
 
<br>
 
<br>
 
Tag is moved to beginning of <code>ukl:title</code> tag so that the whole amendment will be contained within brackets:
 
[[File:Substitution_of_provision_4.png|link=]]
 
<br>
 
<br>
 
<li>Once you are satisfied that the amendment is correct and complete, select <strong>Legislation - Check In</strong> on the menu bar at the top of the page:
 
<br>
 
<br>
 
[[File:Check_in.png|link=]]
 
<br>
 
<br>
 
</li>
 
<br>
 
<li>Click <strong>OK</strong> in the pop-up  [[File:Document_is_checked_in_successfully.png|link=]]</li>
 
<br>
 
<li>Close the <strong>amending provision</strong> window and if you have more update to do, leave XMetaL open and go back to the Editorial Site.</li></ol>
 
 
====Checking the amendment on the Editorial Site====
 
 
<ol><li>Go back to the <strong>Update Details</strong> page and refresh the page by pressing <code>CTRL</code> and <code>F5</code> at the same time.</li>
 
<li>Select the <strong>Newly Edited Version</strong> to see a preview of the updated provision. Check that your amendment and annotation commentary are formatted as you would expect.</li>
 
<li>To check the timeline and see how the provision would look in the context of the whole item of legislation, select the <strong>Preview Legislation</strong> button and check:
 
*You’re satisfied that the amendment has formatted correctly
 
*Check that the newly substituted provision is in the right place and has square brackets surrounding it.
 
*The annotation reference and the text of the annotation are correct. See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]].
 
*The right point in time has been created at provision level to accommodate this amendment.
 
*The right point in time has been created at the level of the whole item of legislation.</li>
 
*You can move between the Points in Time on the timeline correctly
 
<li>Check that the amendment edit status is set to <strong>Edit Complete</strong>. You can also add any notes for the review editor by clicking on the note icon to the right of the edit status. You may need to add a note if there was anything unusual about the amendment that you need to draw to the attention of the review editor.</li>
 
<li>You can now [[Editorial_Update/Starting_Update_Tasks#Navigating_the_Update_Task|navigate]] to the next part of your update task.</li></ol>
 
 
====Unequal Substitution of Sub-provisions====
 
 
 
If your substitution involves [[Editorial_Update/Textual_Amendments/Substitutions/Higher_Level_Substitutions#Unequal_substitutions_of_whole_provisions|unequal substitution of whole provisions]], you should follow the instructions in <strong>Higher Level Substitutions</strong>, as you will need to have checked out the parent level of the provision.
 
 
=====More for less=====
 
More for less <strong>sub-provision</strong> substitutions occur when the substitution results in more sub-provisions than there were previously, such as new sub-provisions (a)-(c) in place of the existing (a) sub-provision.
 
 
To carry out this type of amendment, [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Provisions_and_Sub-Provisions#Carrying_out_the_amendment_in_XMetaL|substitute]] the existing sub-provision in the <strong>amended provision</strong> with the new version from the <strong>amending provision</strong>. Then, copy and paste the new subs-provisions from the <strong>amending provision</strong> after the newly substituted sub-provision in the <strong>amended provision</strong>.  Finally, in the amended sub-provision select the closing <code></ukl:Substitution></code> tag which sits before the closing <code><ukl:text></code> tag and cut and paste (or drag) it so it sits just before the closing <code></ukl:text></code> tag of the last new sub-provision.
 
 
=====Less for more=====
 
Less for more <strong>sub-provision</strong> substitutions occur when the substitution results in fewer sub-provisions than there were previously, such as a new sub-provision (a) substituted in place of the amended provision’s existing (a)-(c) sub-provisions.
 
 
To carry out this type of amendment, [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Provisions_and_Sub-Provisions#Carrying_out_the_amendment_in_XMetaL|substitute]] in the new sub-provision which has the same number/letter as the existing sub-provision. Then, for the sub-provision(s) which are to be substituted out, delete the sub-provision <code><ukl:P2></code>, <code><ukl:P3></code> or <code><ukl:P4></code> tagging (which will completely remove the sub-provision(s).
 
 
<strong>Note:</strong> This method differs from the <strong>whole provision</strong> level [[Editorial_Update/Textual_Amendments/Substitutions/Higher_Level_Substitutions#Less_for_more|'less for more' substitution method]], which repeals the provisions to be substituted out, leaving the provision number and a dotted line.
 
 
See an [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Provisions_and_Sub-Provisions#Less_for_more_substitution_of_a_sub-provision|example]] of a less for more substitution of sub-provisions.
 
 
Once you have completed your unequal substitution, [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Provisions_and_Sub-Provisions#Checking_the_amendment_in_XMetaL|check your amendment in XMetaL]] before [[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Provisions_and_Sub-Provisions#Checking_the_amendment_on_the_Editorial_Site|checking the amendment on the Editorial Site]] as normal.
 
 
====Substitution of Provisions and Sub-provisions Examples====
 
 
=====Less for more substitution of a sub-provision=====
 
 
<strong>Amendment:</strong> 2004 c. 33, Sch. 2 para. 15(1)(c) substituted for Sch. 2 para. 15(1)(b)(c)
 
 
<strong>Instructions:</strong> Carry out substitution of para. 15(1)(c) and then delete the <code><P3></code> tagging for para. 15(1)(b) so that sub-paragraph (b) is completely removed.
 
 
<strong>Result:</strong> See [http://www.legislation.gov.uk/ukpga/2004/33/schedule/2/paragraph/15/2014-04-22 2004 c. 33, Sch. 2 para. 15(1)]
 
 
 
 
{| class="wikitable" align="right"
 
|<strong>Back to</strong> [[Editorial_Update/Textual_Amendments#tna-TextualAmendments|Top]]
 
|}
 
===Higher Level Substitutions===
 
 
 
 
 
{| class="wikitable" align="right"
 
|<strong>Back to</strong> [[Editorial_Update/Textual_Amendments#tna-TextualAmendments|Top]]
 
|}
 
  
 
==Examples==
 
==Examples==
Line 736: Line 36:
  
 
Amendment to earlier affecting provision: If your amendment has itself been amended by another amending document, the amendment may contain square brackets around the subsequently amended text. These should not be included in your final amendment, as the annotation will explain the subsequent amendment. See substitution of [https://www.legislation.gov.uk/ssi/2014/364/schedule/3 S.S.I. 2014/364, Sch.3] by [https://www.legislation.gov.uk/ssi/2017/281/schedule/2 S.S.I. 2017/321, Sch.2] (as amended by [https://www.legislation.gov.uk/ssi/2017/321/regulation/3/made#regulation-3-3 S.S.I. 2017/321, reg. 3]).
 
Amendment to earlier affecting provision: If your amendment has itself been amended by another amending document, the amendment may contain square brackets around the subsequently amended text. These should not be included in your final amendment, as the annotation will explain the subsequent amendment. See substitution of [https://www.legislation.gov.uk/ssi/2014/364/schedule/3 S.S.I. 2014/364, Sch.3] by [https://www.legislation.gov.uk/ssi/2017/281/schedule/2 S.S.I. 2017/321, Sch.2] (as amended by [https://www.legislation.gov.uk/ssi/2017/321/regulation/3/made#regulation-3-3 S.S.I. 2017/321, reg. 3]).
 
 
 
  
 
==Related Topics==
 
==Related Topics==
Line 754: Line 51:
 
**[[Editorial_Update/Textual_Amendments/Repeals/Repeal_of_Provisions_and_Sub-Provisions|Repeal of Provisions and Sub-Provisions]]
 
**[[Editorial_Update/Textual_Amendments/Repeals/Repeal_of_Provisions_and_Sub-Provisions|Repeal of Provisions and Sub-Provisions]]
 
**[[Editorial Update/Textual_Amendments/Repeals/Higher_Level_Repeals|Higher Level Repeals]]
 
**[[Editorial Update/Textual_Amendments/Repeals/Higher_Level_Repeals|Higher Level Repeals]]
 
 
*[[Editorial_Update/Textual_Amendments/Insertions/Insertion_of_Words|Insertion of Words]]
 
*[[Editorial_Update/Textual_Amendments/Insertions/Higher_Level_Insertions|Higher Level Insertions]]
 
*[[Editorial_Update/XML_Tagging|XML Tagging]]
 
*[[Editorial_Update/Manual_Amendments|Manual Amendments]]
 
*[[Editorial Update/Working with XMetaL|Working with XMetaL]]
 
*[[Editorial_Update/Update_Troubleshooting|Update Troubleshooting]]
 
 
*[[Editorial_Update/Textual_Amendments/Insertions/Insertion_of_Words|Insertion of Words]]
 
*[[Editorial_Update/Textual_Amendments/Insertions/Insertion_of_Sub-Provisions|Insertion of Sub-provisions]]
 
*[[Editorial_Update/XML_Tagging|XML Tagging]]
 
*[[Editorial_Update/Manual_Amendments|Manual Amendments]]
 
*[[Editorial Update/Working with XMetaL|Working with XMetaL]]
 
*[[Editorial_Update/Update_Troubleshooting|Update Troubleshooting]]
 

Revision as of 09:43, 21 October 2020

Introduction to Textual Amendments

Textual Amendments generally refer to amendments where there is an authority to change the text of the legislation.

Amendment Types include:

  • Repeal
  • Revoke
  • Omit
  • Insert
  • Add
  • Substitute

These amendments authorise the editor to make changes to the text of the Act. However, where a provision “ceases to have effect”, or where the amendment cannot be applied, you need to follow the procedure for a textual amendment but without actually changing the text.

Textual amendments can affect legislation at any level, for example the whole item of legislation, at high level (e.g. Part, Chapter or Schedule), at provision level, or at the level of words. Our approach to editing the legislation depends on the level at which the amendment is taking place. The guidance on textual amendments is therefore organised by the type of amendment you wish to carry out and what 'level' of the document the amendment affects.

Updating Tables of Contents

Textual amendments to the main table of contents of an item of legislation are not made during editorial update, as the table of contents is dynamically generated. These effects are recorded in TOES, but should have been marked N in the “Applied to database” column with a Note saying 'This amendment not applied to legislation.gov.uk'. The table of contents for this legislation will be dynamically updated when its provisions are revised'. If you encounter an amendment to a table of contents during editorial update, you should check with a Review Editor as a TOES correction may be necessary. Note that amendments to tables of contents elsewhere in the legislation other than the main table of contents (e.g. to a table of contents at the top of Part 2 of a Schedule) will have to be applied as textual amendments.

Examples

Ceases to have effect: http://www.legislation.gov.uk/ukpga/2013/6/section/1

Whole item of legislation level amendment: http://www.legislation.gov.uk/uksi/2018/286

High level amendment: http://www.legislation.gov.uk/wsi/2018/191/schedule/5A

Provision level amendment: http://www.legislation.gov.uk/ukpga/Geo6/12-13-14/88/section/2

Amendment at level of word: http://www.legislation.gov.uk/asp/2016/21/section/228

Amendments to a form which is an image: http://www.legislation.gov.uk/uksi/2013/3156/schedule/paragraph/23/2014-09-15
also: http://www.legislation.gov.uk/ssi/2018/155/schedule/2

Amendment to earlier affecting provision: If your amendment has itself been amended by another amending document, the amendment may contain square brackets around the subsequently amended text. These should not be included in your final amendment, as the annotation will explain the subsequent amendment. See substitution of S.S.I. 2014/364, Sch.3 by S.S.I. 2017/321, Sch.2 (as amended by S.S.I. 2017/321, reg. 3).

Related Topics