Difference between revisions of "Research Tasks/Initial Edit"
| Line 1: | Line 1: | ||
| − | ==Introduction | + | ==Introduction== |
| − | The task involves adding information about new legislation, such as when it comes into force, its geographical extent and whether it contains powers to make subordinate legislation. This information is recorded within the legislation data and is used in setting up the timeline, in force annotations and extent facilities for the legislation and its provisions on the website. The identified powers are expressed on the More Resources tab on the website. Once this information has been entered, the new legislation is deployed to the website as the “Latest Available (Revised)” version. | + | The online initial edit task involves adding information about new legislation, such as when it comes into force, its geographical extent and whether it contains powers to make subordinate legislation. This information is recorded within the legislation data and is used in setting up the timeline, in force annotations and extent facilities for the legislation and its provisions on the website. The identified powers are expressed on the More Resources tab on the website. Once this information has been entered, the new legislation is deployed to the website as the “Latest Available (Revised)” version. |
==Instructions for Online Initial Edit task== | ==Instructions for Online Initial Edit task== | ||
Revision as of 14:01, 17 February 2023
Introduction
The online initial edit task involves adding information about new legislation, such as when it comes into force, its geographical extent and whether it contains powers to make subordinate legislation. This information is recorded within the legislation data and is used in setting up the timeline, in force annotations and extent facilities for the legislation and its provisions on the website. The identified powers are expressed on the More Resources tab on the website. Once this information has been entered, the new legislation is deployed to the website as the “Latest Available (Revised)” version.
Instructions for Online Initial Edit task
Allocating an Online Initial Edit task
On your dashboard click the relevant option on the Workstream - Research menu:
On the next page allocate to yourself an unassigned document from the relevant month:
NOTE: Once the task for the document is allocated, the editor must wait for the auto-processing stage to complete before starting the task (and when the Start Task button displays) – it will show as task Pending until then (keep refreshing the page until the task is available to select).
Once available to start, click Select under the Status heading for the assigned document on your dashboard:
Click the Start Task button to continue:
Open the document you are doing the online initial edit on
You need to look at the extent and commencement information as captured in the Identify Effects task (which will be recorded in the cover markings of the marked up pdf), and also, for primary legislation, locate the provisions which contain powers made under the document (as marked up with a P in a circle).
Primary legislation
To access the marked up pdf, open a new browser tab, go into the Editorial System, search for your document and access the pdf from the Preparation Task menu (click on the pdf icon to open up the marked up pdf for that document):
The pdf will open up in a new window:
Secondary legislation
For straightforward documents, you can simply open the document on legislation.gov.uk and view it there. For more complex documents, you can view the marked up pdf as described above.
First stage: Provision Extent
You will be presented with a form consisting of the table of contents (ToC) for the document you wish to enter extent values for (which can be expanded/contracted by clicking on +/- buttons next to the parent provisions).
The form will be pre-populated with a default extent based on what legislation type it is. In the case of UK SIs and UK PGAs the default is EWSNI and may be wrong.
| Legislation type | Default extent |
|---|---|
| ukpga | EWSNI |
| ukla | EWSNI |
| asp | S |
| anaw | EW |
| mwa | EW |
| ukcm | E |
| nia | NI |
| aip | NI |
| apgb | EWS |
| uksi | EWSNI |
| wsi | EW |
| ssi | S |
| nisi | NI |
| nisr | NI |
| ukci | E |
| ukmd | EWSNI |
| ukmo | EWSNI |
| uksro | EWSNI |
| nisro | NI |
| mnia | NI |
| apni | NI |
You should check the extent values in the ToC against the extent provisions of the document itself, its Explanatory Memorandum (if there is one) and/or original power-conferring provision/s in the enabling Act (where necessary) to satisfy yourself that the extent is correct. See Editorial Principles - Extent and Territorial Application for further details.
The extent values for each provision are entered in the Edit Extent column using the dropdown menu.
Where a provision has a mixed extent (e.g. s. 1(1) extends to EW, s. 1(2) to S and s. 1(3) to NI) the whole provision should receive the widest extent of the combination (e.g. in this case, s. 1 = EWSNI). This scenario would be worth a note to the reviewer.
If you change a parent provision, a message will appear asking if you want the value to be cascaded down into all its children or not:
You are setting the extent at parent level. Press 'Ok' to take it down to all children or press 'Cancel' to keep the change to the parent level only
Where you have already changed a specific child provision value and then subsequently change its higher level parent’s value and agree to cascade the parent value into its children, all the children will be changed EXCEPT for that child value. If you wish to change that value as well you will need to go into that child and change its value.
Where the extent provisions are complicated you should enter details of the authority (i.e. the specific instruction in the extent provision) for the extent value you’ve chosen in the Extent Provision(s) column. This will help the reviewer later on and is not used for any other purpose.
You can also enter a Note against a provision where you think this will be helpful.
There are two tick boxes next to each child provision to allow you to show whether or not it confers a power to make subordinate legislation (Confers power) or contains a blanket amendment (Blanket amendments), and you should tick these for any provisions that confer such a power (in primary legislation) or contain a blanket amendment (in primary and secondary legislation).
The form should save your changes as you go along and tell you as it does so.
When you make any changes to the form, the Validate Extent button at the top left will change from a green tick to a red exclamation mark warning.
Before leaving the extent stage you should click the Validate Extent button so the form can check that the values are correct.
If the document has extent values which are not structurally correct - i.e. where the extent value of all relevant higher level headings/parents is narrower than the extent of any provision - they will be shown with a red border to prompt you to correct them before moving to the next stage.
e.g. in the scenario below:
The Extent of the Title, the Introductory Text and the Main body fragment should all be changed to EWS in the example above. Press the Validate Extent button and the red box errors should be corrected. NB the Signed section and Explanatory Notes fragments should also be set to EWS for this document, but this won't be highlighted by a red box.
If you’ve made a mistake and wish to redo all the extents, you can click the Reset button at the top left of the screen.
When you are satisfied with all the extent values and they have all validated successfully you can move on to the next stage by clicking the Next stage button at the top right. Doing this will prompt a final save of the form. Note that it is possible to return to the extent stage of the task if necessary.
Second stage: Commencement
The Commencement form comprises a ToC containing the commencement details for your document, which are used to construct the I-notes and set up the timeline.
The buttons above the ToC allow you to reset this stage, disable I-notes, change the provision type, undo the extent stage (which allows you to re-access the extent stage to make any further necessary edits without changing any of the values you have previously entered) and move onto the next stage.
If you hover over the small question mark icon next to the Disable I-notes button, you will see the following text box which explains the rare situations, such as with Finance Acts, where you might need to use this facility:
If you need to change the provision type, you can select the relevant provision type using the dropdown box and then press Apply Minor Type, which will change the provision type in the Commencement Provision column.
Where the document has a simple Coming into force date (e.g. which is referenced in the coming into force field at the top of an SI), that date will used as the default start date for all provisions. The default commencement provision reference is also present and you should refine this accordingly (e.g. reg. 1(1) rather than just reg. 1).
Otherwise prosp will be the default start date.
If it it has a complex commencement (which is referenced as “coming into force in accordance with [X provision]” in the coming into force field at the top of an SI) you would enter the start date(s) for each whole provision by entering the relevant date value(s) in the Commencement Date column in accordance with X provision. Similarly, you should refine the default commencement provision reference accordingly.
If the provision comes into force at Royal Assent (primary) or on the Made date (secondary) then you can use the tick box in that column to populate the date. This will change the reference in the I-note from a calendar date to “Royal Assent” or “Made date”, for example:
Check whether any amendments to the commencement provision have been made by identified effects - you can check this by looking in the timeline in the update task for unapplied effects. Open up a new window in your browser and look at the update task for the document you are working on. Use this amended commencement date and see instructions for entering any such amendments below.
As in the previous form, if you change a parent value you will be asked if you wish to cascade that value into the children. Click OK to cascade or Cancel to change only the parent value. Any child date that has already been entered separately will not be changed if you subsequently cascade a parent value.
When you enter a start date the form will automatically populate the Qualification column (which corresponds to the IF Date Qualification field in TOES) with the value wholly in force. If this is incorrect and the provision is not wholly in force you should change it to the appropriate value (e.g. for specified purposes) using the dropdown menu. If you choose the qualification Other or Other(no date) here you should also ensure you enter text in the Other Qualification column (e.g. comes into force on exit day).
If only a part (a certain sub-provision or sub-provisions) and not the whole provision is commenced then you can specify which sub-provision or sub-provisions in the Affected Sub-Provision(s) column. These should be grouped together if they share the same date AND qualification, otherwise sub-provisions with different dates or different qualifications should be dealt with separately.
The sub-provision with the earliest start date should be entered first, then if you require to enter further details for further commencements within the provision you should click on the Further Detail icon. You can then add as many rows as you need (by clicking the Add Row button) to enter all the commencement data for that provision in date order. When you’ve finished adding data you can click Save. If you make a mistake and add a row you don’t want, you can remove it by clicking the Remove button next to it:
Where more than one row of commencement data is added to a provision the Further Detail icon is highlighted in purple.
The authority for the start date and qualification (i.e. the specific instruction in the commencement provision) should be cited in the Commencement Provision column. This information is not only there to help the reviewer, but will also included in the eventual In Force notes (I-notes).
If the commencement date has been amended then this needs to be reflected in the I-note. Select “other” in the Qualification column and then in the Other Qualification column you add “(as amended by [amending document details])”, for example:
Notes can be added for the reviewer next to each provision by the editor if felt to be really necessary.
Before leaving the commencement stage you should click the Validate button so the form can check that the values are correct.
Where the start date value of a parent provision is later than the extent of any of its children that parent provision will be shown with a red border to prompt you to correct it before moving on.
Note: if the start date on any of the relevant provisions are earlier than they need to be the document will still validate but will be incorrect, so look out for this.
The Introductory Text, Signature and Explanatory Notes and/or Note as to earlier Orders (which are not technically parent provisions) should also share the earliest start date of any provision in the document. The validation is currently not working to check these elements. This is with TSO to fix.
When you are satisfied the commencement data is correct and validated, you should click Next stage to move on.
For advice about commencements, please see Editorial Principles - Commencement.
Third stage: Preview Initial Edit
The preview stage allows you to generate the points in time for the revised document based on the data you have entered in the previous two stages. You can preview what the revised document will look like when it is published on legislation.gov.uk and check that the extents, start dates and I-notes for all its provisions are correct.
Click the Generate PiTs button to generate the revised version of the document:
Thereafter the button becomes Regenerate PiTs if you need to use it again. NB There is a slight issue with this button in that if the document is reset by deleting the tasks the rdf is not completely cleared and the button says Regenerate instead of Generate.
Use the Website preview button to see how the document will look on the website.
Use the Website skeleton preview button to see a skeleton view of the document (minus content), showing start dates, extents, confers power and blanket amendments attributes and I-notes.
Each whole provision should receive its widest extent and each parent the widest extent of any of its children.
Each whole provision should receive its earliest start date and each parent the earliest start date of any of its children.
You should check that the I-notes are present against all relevant provisions and they have the correct date, qualification and commencement provision.
Each prosp provision should show its status as prospective and show an I-note explaining it is not in force at Royal Assent/Made date.
Where any provision has a start date more than 28 days after the Royal Assent or Made date of the document, it will show as prospective but with an I-note explaining it has a fixed future date (FFD). Instead of receiving a start date (which may interfere with updating interim amendments), it will be given a coming into force effect in TOES which will be added to its update timeline to be applied as part of update.
Where this happens you will see a message like this:
The Made Date is set at 08/01/2019. Any Pits after 07/02/2019 will not be generated and be recorded as future effects. Please use the Effects Preview to review these.
Use the Effects preview button to see such +28 day FFD effects, which will be marked as unapplied, along with the coming into force effects for prospective provisions (marked as applied) and the applied effects for provisions coming into force on either RA/Made date or dates within one month of RA/Made date.
After checking the previews to make sure everything is correct, the editor clicks Complete to finish the task and make it available to the reviewer.
If you are unhappy with any aspect of what you have done so far, you can click Undo Extent or Undo Commencement to return to the relevant part of the task and correct your data.
Reviewer stages
The reviewer task has an two extra stages after the preview and publishing stage: an option to correct effects in a spreadsheet download in stage four and and option to Upload Scanned PDF in stage five where the reviewer can upload a corrected marked up pdf if necessary or otherwise tick the box to skip this stage and complete the review task.
Issues with Initial Edit
Invalid cast message
If you see this message when you are trying to generate the PiT, there is an error in the way the dates have been entered and the task will need to be deleted (by an Editorial Admin account user) and redone.
Missing xml
If you find your initial edit task get stuck, it may be an idea to check if the document has xml on legislation.gov.uk when you allocate the initial edit task and, if not, ask a reviewer to do a TOES correction to mark the effects with Ns.