Difference between revisions of "Editorial Update/Textual Amendments/Insertions/Provision Level Insertions"

From Legislation Community Editorial Wiki
Jump to navigation Jump to search
Line 286: Line 286:
 
|<strong>Step Four</strong>
 
|<strong>Step Four</strong>
  
−
====Insertion of words====
+
<ol><li>Return to the <strong>Update Details</strong> page and refresh the page by pressing <code>CTRL</code> and <code>F5</code>. The <strong>Edit Status</strong> should change to <strong>Edit Complete</strong>.</li>
 +
<br>
 +
<li>If there was anything unusual about the amendment that you need to draw to the attention of the review editor, you can add a note by clicking on the note icon to the right of the edit status.</li>
 +
<br>
 +
<li>View your amendment by selecting the <strong>Newly Edited Version</strong> tab (to see the provision text and a summary of the provision attributes) or the <strong>Preview Legislation</strong> button (to see a website <strong>Preview</strong> of the provision). Check that:
 +
<br>
 +
*your amendment and annotation commentary are in the right place, are formatted as you would expect and that the amendment is surrounded by correctly placed square brackets.
 +
 
 +
*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 inserted text. See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]].</li>
 +
 
 +
<br>
 +
<br>
 +
<u>Insertion of words</u>
  
−
<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:
 
*The new words are inserted in the right place and have square brackets surrounding them:
  
Line 300: Line 308:
 
[[File:Insertion of_Words_7.png|link=]]
 
[[File:Insertion of_Words_7.png|link=]]
  
−
<p>See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]].</p>
 
  
 +
<u>Insertion of a sub-provision</u>
 +
<br>
 +
<br>
 +
[[File:Insertion_of_sub-provision_6.png|link=]]
 +
<br>
 +
<br>
 
*The right point in time has been created at provision level to accommodate this amendment:
 
*The right point in time has been created at provision level to accommodate this amendment:
−
 
+
<br>
 +
<br>
 
[[File:Insertion of_Words_8.png|link=]]
 
[[File:Insertion of_Words_8.png|link=]]
−
 
+
<br>
 +
<br>
 
*The right point in time has been created at the level of the whole item of legislation:
 
*The right point in time has been created at the level of the whole item of legislation:
−
 
+
<br>
 +
<br>
 
[[File:Insertion of_Words_9.png|link=]]
 
[[File:Insertion of_Words_9.png|link=]]
 +
<br>
 +
<br>
 
*You can move between the Points in Time on the timeline correctly.</li>
 
*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)]
+
*if you need to check any of the attributes of the provision you have amended, this can easily be done by selecting the <strong>Newly Edited Version</strong> tab where you will see the relevant attributes of your provision listed. 
−
 
+
<br>
−
====Insertion of a sub-provision====
+
<br>
−
 
+
If you need to make any corrections to the amendment, check the provision back out and make any changes as necessary in XMetaL before checking the provision back in and previewing the provision again. Note that if you only need to correct an annotation, you can click on the "Edit" button to the right of the annotation in <strong>Preview</strong> to edit it without having to check the provision out again in XMetaL.
−
<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>
+
<br>
−
<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>
+
<br>
−
<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:
+
<li>In the <strong>Preview</strong> check the timeline and see how the provision would look in the context of the whole item of legislation. Make sure that the correct <strong>Point in Time</strong> has been created on the timeline to accommodate your amendment and that you can move between the Points in Time on the timeline correctly. If there are any errors in the timeline, correct them using the [[Editorial_Update/Update_Troubleshooting#Issue:_Timeline_errors_-_using_the_Timeline_Resolver|Timeline Resolver]].</li>
−
*You’re satisfied that the amendment is formatted correctly.
+
<br>
−
*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>
 
<br>
 +
<li>Once you have finished checking the amendment on the Editorial Site, the update task will be complete and you can [[Editorial_Update/Starting_Update_Tasks#Navigating_the_Update_Task|move on]] to your next update task.</li></ol>
  
−
See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]].
 
  
 +
<strong>Video Instructions:</strong> [https://www.youtube.com/watch?v=2wUQMgy8Vok Insertion of words (wholly in force and whole extent)]
  
−
*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)]
 
<Strong>Video Instructions:</strong> [https://www.youtube.com/watch?v=HZZBQ_OI9bw Insertion of a sub-provision (wholly in force and whole extent)]

Revision as of 08:09, 16 September 2021

OVERVIEW

Insertions of words and insertions of sub-provisions are carried out at provision level. Insertions of whole provisions need to be done at the parent level and are described on the Higher Level Insertions page.

Insertion of words

Whole extent and wholly in force

Provision Level Insertions 1.png

Provision Level Insertions 2.png

https://www.legislation.gov.uk/uksi/2020/750/regulation/1

How to carry out an insertion of words Specific Update Issues

Limited extent

Provision Level Insertions 10.png
How to carry out an insertion of words Specific Update Issues

In force for specified purposes only

Provision Level Insertions 5.png

Provision Level Insertions 6.png
How to carry out an insertion of words Specific Update Issues

Insertion of a sub-provision

Whole extent and wholly in force

Provision Level Insertions 3.png

Provision Level Insertions 4.png

https://www.legislation.gov.uk/uksi/2020/568/regulation/3/2021-04-23

How to carry out an insertion of a sub-provision Specific Update Issues

Limited extent

Provision Level Insertions 9.png
How to carry out an insertion of a sub-provision Specific Update Issues

In force for specified purposes only

Provision Level Insertions 7.png

This example also shows how s. 1 was renumbered as s. 1(1) (for specified purposes) by the previous amendment to allow for the insertion of s. 1(2) (for specified purposes).

How to carry out an insertion of a sub-provision Specific Update Issues

IN MORE DETAIL

Related reading: Approach to Update - Some Basic Rules and Exceptions, Limited extent amendments, Applying partially in force amendments which are then brought further into force over time

Carrying out an insertion of words in XMetaL

These instructions assume you have checked out the relevant provision that is to be amended, that you have set up your XMetaL workspace, and that you are now ready to carry out the amendment. For guidance on the steps required to reach this point, see Starting Update Tasks.

Step One
  1. In the amending provision window:
    • Read what the amendment is and where in the amended provision 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.

    Insertion of Words 1.png

  2. In the amended provision window, place the cursor in the appropriate position in the text (i.e. where the word or words are to be inserted).

    WARNING: In secondary legislation, drafters' footnotes 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 drafter's footnote reference that relates to it. See Taking into account drafters' footnotes when inserting words into secondary legislation.


  3. In the Resource Manager window single click on the task to highlight it.


  4. Your next action will be determined by whether the amendment covers the whole extent and is either wholly in force or in force for specified purposes, or is for a limited extent, consequently Step Two is described separately for each scenario.

Whole extent

Step Two - whole extent (wholly in force or in force for specified purposes only)


On the menu bar at the top of the page select Legislation - Textual Amendments - Addition.

Insertion of Words 3.png

This will:

  • Automatically insert the new word or words, bracketed by opening <addition> and closing </addition> tags in the amended provision:



Insertion of Words 5.png

  • Automatically insert the annotation for this amendment at the end of the amended provision:



Insertion of Words 4.png

  • Generate a green tick next to the task in the Resource Manager window to show that it has been completed.


Once the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the amended provision window.

Your next task will be to check the amendment in XMetaL (Step Three), followed by the final task of checking the amendment on the Editorial Site (Step Four).


Limited extent

Step Two - limited extent

On the menu bar at the top of the page select Legislation - Textual Amendments - Limited Extent Addition. In the pop-up 'XMetaL Author Essential', check the Extent entered is correct and click OK. This will:

  • Automatically insert the new word or words, bracketed by opening <addition> and closing </addition> tags in the amended provision.
  • Automatically insert the annotation for this amendment at the end of the amended provision, including the limited extent in brackets after the effect, e.g.
Words in art. 7(2) inserted (E.W.S.) (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
  • Generate a green tick next to the task in the Resource Manager window to show that it has been completed.

Once the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the amended provision window.

Your next task will be to check the amendment in XMetaL (Step Three),followed by the final task of checking the amendment on the Editorial Site (Step Four).

See more on limited extent amendments.

Carrying out an insertion of a sub-provision in XMetaL

If you need to insert a whole provision, follow the instructions for Higher Level Insertions

Note: These instructions assume you have checked out the relevant provision that is to be amended, that you have set up your XMetaL workspace, and that you are now ready to carry out the amendment. For guidance on the steps required to reach this point, see Starting Update Tasks.

Step One
  1. In the amending provision window:
    • Read what the amendment is and where in the amended provision it is to be made.
    • Select the appropriate <ukl:P#> tag to highlight and copy the sub-provision to be inserted:

    Sub-Provision: <ukl:P2>

    Sub-sub-provision: <ukl:P3>


    Note: you can also select the <BlockAmendment> tag, if there is one.

    You can right-click and copy or use the standard ‘edit’ and ‘copy’ menu options from the menu bar.

    Insertion of sub-provision 1.png


  2. In the amended provision, place the cursor after the closing ukl:P2 or ukl:P3 tag of the sub-provision that precedes the one you are inserting.

  3. Single click on the task to highlight it in the Resource Manager window.

    4. Your next action will be determined by whether the amendment covers the whole extent and is either wholly in force or in force for specified purposes, or is for a limited extent, consequently Step Two is described separately for each scenario.

Whole extent

Step Two - whole extent (wholly in force or in force for specified purposes only)

On the menu bar at the top of the page select Legislation - Textual Amendments - Addition:

Insertion of sub-provision 2.png

This will:

  • Automatically insert the new sub-provision, bracketed by opening <addition> and closing </addition> tags in the amended provision:

Insertion of sub-provision 4.png

  • Automatically insert the annotation for this amendment at the end of the amended provision:

Insertion_of_sub-provision_3.png

  • Generate a green tick next to the task in the Resource Manager window to show that it has been completed.


Your next task will be to check the amendment in XMetaL, followed by the final task of checking the amendment on the Editorial Site.

Limited extent

Step Two - limited extent

On the menu bar at the top of the page select Legislation - Textual Amendments - Limited Extent Addition. In the pop-up 'XMetaL Author Essential', check the Extent entered is correct and click OK; this will:

  • Automatically insert the new sub-provision, bracketed by opening <addition> and closing </addition> tags in the amended provision;
  • Automatically insert the annotation for this amendment at the end of the amended provision, including the limited extent in brackets after the effect; and
  • Generate a green tick next to the task in the Resource Manager window to show that it has been completed.

Once the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the amended provision window.

Your next task will be to check the amendment in XMetaL, followed by the final task of checking the amendment on the Editorial Site.

See more on limited extent amendments.

Checking the amendment in XMetaL

Related reading: Approach to Update - Some Basic Rules and Exceptions
Step Three

  1. Once the insertion has been made 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 In Force Date Qualification (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 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 Annotation Conventions.


  2. Scroll back up to the where the amendment was made in the amended provision and check the inserted wording or sub-provision is positioned correctly. If inserting a word or words, delete any unnecessary spaces between the existing punctuation and the inserted tags and words, or insert a space if appropriate.


    Where words are inserted and the inserted text starts with punctuation, leave a space between the existing text and the opening square bracket, and where there is punctuation in the existing text immediately after the closing square bracket, close up any space between the closing square bracket and the punctuation, i.e.:

    Existing text [, inserted words], existing text.


    For example:
    Insert Words Whole After.jpg

    In this example, the space has been closed up between the closing addition tag and the semi-colon (at the position of the cursor).


    3. See also: Approach to Update - Some Basic Rules and Exceptions for further guidance on other edits you may need to make.

  3. Once you are satisfied that the amendment is correct and complete, select Legislation - Check In on the menu bar at the top of the page:


    Check in.png


  4. Click OK in the pop-up

    Document is checked in successfully.png


  5. Close the amending provision window and go back to the Editorial Site to check the amendment in Step Four (leaving XMetaL open if you have more update to do after this amendment).

Checking the amendment on the Editorial Site

Related reading: Approach to Update - Some Basic Rules and Exceptions
Step Four
  1. Return to the Update Details page and refresh the page by pressing CTRL and F5. The Edit Status should change to Edit Complete.

  2. If there was anything unusual about the amendment that you need to draw to the attention of the review editor, you can add a note by clicking on the note icon to the right of the edit status.

  3. View your amendment by selecting the Newly Edited Version tab (to see the provision text and a summary of the provision attributes) or the Preview Legislation button (to see a website Preview of the provision). Check that:
    • your amendment and annotation commentary are in the right place, are formatted as you would expect and that the amendment is surrounded by correctly placed square brackets.
    • 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 inserted text. See more detail on annotations in Annotation Conventions.


    Insertion of words
    • The new words are inserted in the right place and have square brackets surrounding them:
    Insertion of Words 6.png
    • The annotation reference and the text of the annotation are correct:
    Insertion of Words 7.png Insertion of a sub-provision

    Insertion of sub-provision 6.png

    • The right point in time has been created at provision level to accommodate this amendment:


    Insertion of Words 8.png

    • The right point in time has been created at the level of the whole item of legislation:


    Insertion of Words 9.png

    • You can move between the Points in Time on the timeline correctly.
    • if you need to check any of the attributes of the provision you have amended, this can easily be done by selecting the Newly Edited Version tab where you will see the relevant attributes of your provision listed.


    If you need to make any corrections to the amendment, check the provision back out and make any changes as necessary in XMetaL before checking the provision back in and previewing the provision again. Note that if you only need to correct an annotation, you can click on the "Edit" button to the right of the annotation in Preview to edit it without having to check the provision out again in XMetaL.

  4. In the Preview check the timeline and see how the provision would look in the context of the whole item of legislation. Make sure that the correct Point in Time has been created on the timeline to accommodate your amendment and that you can move between the Points in Time on the timeline correctly. If there are any errors in the timeline, correct them using the Timeline Resolver.


  5. Once you have finished checking the amendment on the Editorial Site, the update task will be complete and you can move on to your next update task.


Video Instructions: Insertion of words (wholly in force and whole extent)


Video Instructions: Insertion of a sub-provision (wholly in force and whole extent)


SPECIFIC UPDATE ISSUES

Related reading: Approach to Update - Some Basic Rules and Exceptions
  1. Taking into account drafters' footnotes when inserting words into secondary legislation
  2. Inserting definitions and paragraphs within definitions

RELATED PAGES

Retrieved from ‘http://community.legislation.gov.uk/mediawiki/index.php?title=Editorial_Update/Textual_Amendments/Insertions/Provision_Level_Insertions&oldid=6671’