Difference between revisions of "Editorial Update/Textual Amendments"

From Legislation Community Editorial Wiki
Jump to navigation Jump to search
 
(32 intermediate revisions by the same user not shown)
Line 17: Line 17:
 
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.
 
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==
+
===Specific Amendment Types===
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==
+
====Insertions====
  
===Insertion of Words===
+
These textual amendments include 'insertions' and 'additions'.
  
====Carrying out the amendment in XMetaL====
+
The guidance is split into 2 separate sections:
  
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]].
+
*<strong>[[Editorial_Update/Textual_Amendments/Insertions/Provision_Level_Insertions|Provision Level Insertions]]</strong>
 +
*<strong>[[Editorial_Update/Textual_Amendments/Insertions/Higher_Level_Insertions|Higher Level Insertions]]</strong>
  
<ol><li>In the <strong>amending provision</strong> window:
+
These pages aim to provide a 'how to guide' to carrying out amendments in XMetaL and checking you have got the right results on completion. Make sure you've read the guidance on [[Editorial_Update/Starting_Update_Tasks|'Starting Update']].
*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=]]
+
{| class="wikitable"  
+
|<strong>See also:</strong> [[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#APPROACH_TO_UPDATE_-_SOME_BASIC_RULES_AND_EXCEPTIONS|Approach to Update - Some Basic Rules and Exceptions]], [[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#SPECIFIC_UPDATE_ISSUES|Specific Update Issues]] and [[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#UPDATE_TROUBLESHOOTING|Update Troubleshooting]]  
<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)]
 
 
 
====Scenarios====
 
 
 
=====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===
+
====Substitutions====
 
 
====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)]
+
The guidance is split into 2 separate sections:
  
===Examples===
+
*<strong>[[Editorial_Update/Textual_Amendments/Substitutions/Provision_Level_Substitutions|Provision Level Substitutions]]</strong>
 +
*<strong>[[Editorial_Update/Textual_Amendments/Substitutions/Higher_Level_Substitutions|Higher Level Substitutions]]</strong>
  
===Insertion of a provision that was previously repealed===
+
These pages aim to provide a 'how to guide' to carrying out amendments in XMetaL and checking you have got the right results on completion. It is assumed that you have already read the guidance on [[Editorial_Update/Starting_Update_Tasks|Starting Update]].
  
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':
+
{| class="wikitable"
 
+
|<strong>See also:</strong> [[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#APPROACH_TO_UPDATE_-_SOME_BASIC_RULES_AND_EXCEPTIONS|Approach to Update - Some Basic Rules and Exceptions]], [[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#SPECIFIC_UPDATE_ISSUES|Specific Update Issues]] and [[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#UPDATE_TROUBLESHOOTING|Update Troubleshooting]]  
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]]  
 
 
|}
 
|}
 +
====Repeals====
  
==Substitutions==
+
These textual amendments include effects such as 'repealed', 'omitted', 'expires' and 'ceases to have effect'. These amendments authorise the editor to make physical changes to the text of the item of legislation. However, where the type of effect is 'ceases to have effect'  the editor will follow the procedure for a textual amendment but without actually changing the text (using the 'retain text' options in XMetaL).
  
===Substitution of Words===
+
The guidance is split into 2 separate sections:
  
====Carrying out the amendment in XMetaL====
+
*<strong>[[Editorial_Update/Textual_Amendments/Repeals/Provision_Level_Repeals | Provision Level Repeals]]</strong>
 +
*<strong>[[Editorial Update/Textual_Amendments/Repeals/Higher_Level_Repeals|Higher Level Repeals]]</strong>
  
<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]].  
+
These pages aim to provide a 'how to guide' to carrying out amendments in XMetaL and checking you have got the right results on completion. It is assumed that you have already read the guidance on [[Editorial_Update/Starting_Update_Tasks|Starting Update]].
  
<ol><li>In the <strong>amending provision</strong> window:
+
{| class="wikitable"  
*Read what the amendment is and where in the <strong>amended provision</strong> it is to be made. 
+
|<strong>See also:</strong> [[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#APPROACH_TO_UPDATE_-_SOME_BASIC_RULES_AND_EXCEPTIONS|Approach to Update - Some Basic Rules and Exceptions]], [[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#SPECIFIC_UPDATE_ISSUES|Specific Update Issues]] and [[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#UPDATE_TROUBLESHOOTING|Update Troubleshooting]]  
*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>
 
 
 
===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===
+
<!-- RELOCATE THIS
 
+
==Some Textual Amendment Examples==
 
 
{| 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==
 
  
 
Ceases to have effect: http://www.legislation.gov.uk/ukpga/2013/6/section/1
 
Ceases to have effect: http://www.legislation.gov.uk/ukpga/2013/6/section/1
Line 567: Line 68:
 
Whole item of legislation level amendment: http://www.legislation.gov.uk/uksi/2018/286
 
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  
+
High level insertion: 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
 
Provision level amendment: http://www.legislation.gov.uk/ukpga/Geo6/12-13-14/88/section/2
Line 576: Line 77:
 
also: http://www.legislation.gov.uk/ssi/2018/155/schedule/2
 
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 [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==
 
 
 
*[[Editorial_Update/Textual_Amendments/Insertions|Insertions]]
 
**[[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/Textual_Amendments/Insertions/Higher_Level_Insertions|Higher Level Insertions]]
 
*[[Editorial_Update/Textual_Amendments/Substitutions|Substitutions]]
 
**[[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Words|Substitution of Words]]
 
**[[Editorial_Update/Textual_Amendments/Substitutions/Substitution_of_Provisions_and_Sub-Provisions|Substitution of Provisions and_Sub-Provisions]]
 
**[[Editorial_Update/Textual_Amendments/Substitutions/Higher_Level_Substitutions|Higher Level Substitutions]]
 
*[[Editorial_Update/Textual_Amendments/Repeals|Repeals]]
 
**[[Editorial_Update/Textual_Amendments/Repeals/Repeal_of_Words|Repeal of Words]]
 
**[[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/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]]
 

Latest revision as of 16:13, 6 March 2025

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.

Specific Amendment Types

Insertions

These textual amendments include 'insertions' and 'additions'.

The guidance is split into 2 separate sections:

These pages aim to provide a 'how to guide' to carrying out amendments in XMetaL and checking you have got the right results on completion. Make sure you've read the guidance on 'Starting Update'.

See also: Approach to Update - Some Basic Rules and Exceptions, Specific Update Issues and Update Troubleshooting

Substitutions

The guidance is split into 2 separate sections:

These pages aim to provide a 'how to guide' to carrying out amendments in XMetaL and checking you have got the right results on completion. It is assumed that you have already read the guidance on Starting Update.

See also: Approach to Update - Some Basic Rules and Exceptions, Specific Update Issues and Update Troubleshooting

Repeals

These textual amendments include effects such as 'repealed', 'omitted', 'expires' and 'ceases to have effect'. These amendments authorise the editor to make physical changes to the text of the item of legislation. However, where the type of effect is 'ceases to have effect' the editor will follow the procedure for a textual amendment but without actually changing the text (using the 'retain text' options in XMetaL).

The guidance is split into 2 separate sections:

These pages aim to provide a 'how to guide' to carrying out amendments in XMetaL and checking you have got the right results on completion. It is assumed that you have already read the guidance on Starting Update.

See also: Approach to Update - Some Basic Rules and Exceptions, Specific Update Issues and Update Troubleshooting