| Test Case | Expected outcome | Pass / Fail | Tester's Comments |
|---|
| 1 | As an OPC user, setup a test Bill project | Expand |
|---|
| Login to Lawmaker as an OPC user From the Dashboard, click Create Select UK Public Bill > Government Bill Create some sections and Schedules in the Bill, using the Editor Save and close the Editor (Alternatively, on the Project Tab, from the Document Actions menu, import a UK PGA from Legislation.gov.uk ) |
| Able to create a UKPGA Bill project | (delete as appropriate) | |
| 2 | As an OPC user, create a Traditional List of Draft Amendments (LoDA) for House of Lords amendments Creating new amendments on a List of Draft Amendments (LoDA) | Expand |
|---|
| Login to Lawmaker as an OPC user Open the UK Bill project On the Amendment Workspace tab, click New In the modal, pick Traditional type of amendment list Bill version: "as introduced" version House: "House of Lords" Stage: “Committee” Specify an unique List name and select a Proposer Click Create |
| The Editor will be opened containing the draft list of amendments template And the Bill name will appear at the top of the template And the stage will match what I specified And the proposer will match what I specified | | |
| 3 | As an OPC user, create some amendments in the LoDA Drafting and editing amendments Create at least three amendments, so you can test other features (like ‘bulk update status’) in later steps. Make sure your amendments are explicitly referring to clauses and schedules - this will allow you to test the Order of Consideration later. Examples of the formatting and phrasing of Lords amendments can be found in this PDF: Digital Markets Bill: Lords amendment list | Expand |
|---|
| With the LoDA open in the Editor, click inside the first 'Instruction' placeholder Press Enter and select an amendment from the Content Completion Assistant Repeat the preceding step to create the following types of amendments: - leave out clause or leave out schedule - new clause - new schedule - page-line - stand part motion - amendment to amendment Save and close the Editor |
| A new amendment appears in the Editor And there are custom placeholders for Page-line, New Clause, New Schedule, and Stand part amendments And the proposer is the same as the proposer of the previous amendment And an entry appears in the Structure view And when I click save, D numbers will be assigned to all my amendments And the Dnumber D number assignment shows the user's organisation abbreviation, followed by a number that increases sequentially by 1 and has no leading zeros e.g. OPC1, OPC2 The amendments are also visible in the table on the Amendment Manager tab | | |
| 4 | Share the Bill with the House of Lords Sharing a document with another organisation | Expand |
|---|
| From the Project Tab, click the Actions menu next to the working version of the Bill Click Share In the modal, select House of Lords from the drop-down Click Share |
| Able to share the Bill using the Share action Able to select House of Lords in the modal Able to view the Bill project as a House of Lords user (necessary for the next step of this script) | | |
| 5 | Login as a House of Lords user and create a published ‘As Introduced’ version of the bill Managing document information Preparing a bill for introduction | Expand |
|---|
| Login to Lawmaker as a House of Lords user From the Dashboard, navigate to the Bill project From the Actions menu next to the significant version created in the previous step, select Duplicate; in the modal, create a new folder and give the duplicate a name, e.g. ‘bill as introduced’ Update the Document Information of the newly created working version (either from the Editor, or from the Actions menu next to your version on the Project Tab): change the Version rubric to ‘As Introduced’; ensure Printed by is set to the Lords Generate a PDF of this version; ensure ‘Line Numbering’ is ticked in the Generate PDF modal On the Project Tab, expand the snapshots below your version and click the Actions menu next to the PDF snapshot version; select Publish |
| A significant version is created The top-left drop-down filter on the ‘Amendment Workspace’ and ‘Amendment' Manager' tabs shows an ‘As Introduced’ version | | |
| 6 | Login as an OPC user and check that the amendments you drafted earlier are still visible on the Amendment Manager tab | Amendments are still visible on the Amendment Manager tab | | |
| 7 | Turn on/off line numbering for amendments Turn on/off line number on amendments (including ping pong motions) | Expand |
|---|
| With the LoDA open in the Editor Right-click on an amendment Select Update line number status Choose either ‘No line numbers’ or ‘Add line numbers’ Generate a PDF by clicking Document > Generate PDF |
| For amendments where ‘add line numbers’ has been selected: line numbers appear every five lines For amendments where ‘no line numbers’ has been selected: no line numbers appear | | |
| 8 | Change the Proposer of a Lords amendment and add supporters Managing proposers and supporters | Expand |
|---|
| With the LoDA open in the Editor Click on the Proposer name above an amendment in the main editor window In the Manage Proposers and Supporters modal which appears, use the Proposers and Supporters fields to add members names to the amendment Click Update to confirm your selection |
| Able to bring up the Manage Proposers and Supporters modal Able to search for and select names in both fields On clicking Update, chosen names appear in the main Editor window above the relevant amendment | | |
| 9 | Generate PDF of Lords amendment LoDA with D-Numbers Generating and viewing a PDF | Expand |
|---|
| With the LoDA open in the Editor Click Document Select Generate PDF In the Generate PDF modal, select ‘Show D-numbers’ |
| PDF is generated and a green success toastie appears in the bottom-right of the screen The ‘View PDF’ button in the green success message can be clicked Clicking the ‘View PDF’ button opens the PDF in a new tab PDF shows the D-numbers of all the amendments | | The user manual will need to be updated for v16 |
| 10 | As an OPC user, Submit Lords amendments from the LoDA Submitting amendments | Expand |
|---|
| title | Steps (from the Editor) |
|---|
| Open the LoDA in the Editor Open the ‘Document Information’ panel on the right-hand side Click Submit List |
| Expand |
|---|
| title | Alternative Steps (from the Amendment Manager tab) |
|---|
| After saving and closing the LoDA, go to the Amendment Manager tab Select one or more of the amendments there From the Amendment Actions menu, select Submit amendments |
| Warning modal appears asking you to confirm that you want to submit the amendments Modal contains the option to ‘mark amendments as government amendments' On confirming, a progress bar appears After submission completes, the ‘Amendment information’ panel shows the Status as ‘Submitted’ for all amendments in the list If you are submitting from the Amendment Manager tab, a green success toastie should appear if the amendments were submitted successfully | | |
| 11 | As a HoL user, view submitted Lords amendments in ephemeral list Opening amendments in the Editor (creating temporary lists) | Expand |
|---|
| Login to Lawmaker as a House of Lord user Open the Bill project On the Amendment Manager tab, tick the checkbox next to the OPC-submitted amendments From the Amendment Actions menu, select Create temporary list |
| Editor opens, showing the selected amendments The amendments are editable | | |
| 12 | Table and Reject amendments from the ephemeral list Tabling UK amendments (incl. 'ready for publishing') | Expand |
|---|
| With the temporary list open in the Editor Click within the text of one of the amendments Expand the Amendment Status panel on the right-hand side Click the ‘Tabled’ or ‘Rejected’ button Save the list |
| Able to view the ‘Tabled' and ‘Rejected’ buttons Able to click either button On clicking, the editor locks and a loading spinner briefly displays On saving, the ‘Status’ shown in the Amendment Status panel shows either Tabled or Rejected | | |
| 13 | Bulk update the other amendments' statuses https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526674/Tabling+UK+amendments (+incl. '+ready for publishing')+for+publishing#To-update-statuses-in-one-go | Expand |
|---|
| With the temporary list open in the Editor Expand the Amendment Status panel on the right-hand side Click the Bulk update statuses button In the Update Amendment Statuses modal, in the ‘Amendments to update’ dropdown, select those amendments which you did not update in the previous step; select ‘Submitted to Tabled’ in the ‘Status transition’ dropdown Click Update Save the list |
| After clicking Update, Editor briefly locks and loading spinner appears Green success toastie appears in the top-right of the screen After saving, the status of the amendments (in the Amendment Information panel) is now 'Tabled' | | |
| 14 | Update Lifecycle Event for one of the amendments Undoing an amendment status/managing lifecycle events | Expand |
|---|
| Click within the text of one of the amendments which was Tabled Expand the Amendment Status panel Click Manage lifecycle events Use the delete button to remove the ‘Tabled’ event Click Update |
| The status of the selected amendment (in the Amendment Information panel) changes to ‘Submitted’ | | |
| 15 | Create Lords Daily Sheet Generating a Lords Daily Sheet (incl. unnumbered supplementary sheets) | Expand |
|---|
| On the Amendment Manager tab, click the Amendment Actions menu and select Create Official List In the Create amendment list modal, select ‘Lords Daily Sheet’ from the ‘Amendment list’ dropdown In the Bill Version tab, there should be only one option (the published Bill version) In the Stage/Committee dropdown, select ‘in Committee of the Whole House’ Select today’s date as the cut-off date, and a time slightly in the future for the cut-off time Pick any name for the list Click Create |
| A Lords daily sheet will open in the Editor containing all the tabled amendments The amendments will not be numbered Amendments will be sorted according to the Lord's sort order; refer to the Manual for guidance: Sorting logic used by Lords amendment lists | | |
| 16 | Move an amendment on a Lords Daily Sheet using the Structure View Using the structure view | Expand |
|---|
| Drag an amendment into a new location using the Structure View on the left-hand side of the Editor window |
| Editor is updated showing the amendment in the new location Structure view also updates | | |
| 17 | Create an Order of Consideration for Lords amendments Creating an Order of Consideration To test this functionality, some of the amendments you created in earlier steps must refer to numbered clauses and schedules. | Expand |
|---|
| From the Amendment manager tab click on Order of Consideration button Change the Order so that you can manipulate it such that amendments appear before others e.g. Schedule 1 Clause(s) 1-2 Click Save Generate another Lords Daily Sheet |
| Able to add and amend the Order of Consideration using the modal In the generated Daily Sheet, the amendments are sorted according to the OoC | | |
| 18 | Sort amendments by Order of Consideration on the 'Amendment Manager' tab | Expand |
|---|
| Click the OoC Sort button on the Location column |
| Amendments are sorted in the list according to the OoC | | |
| 19 | Update Daily Sheet Document Information Managing document information | Expand |
|---|
| From the Official Lists tab, open the Official List you created earlier in the Editor Expand the Document Information panel Populate the four fields here with information, for example: List Number: III Version: revised Session: [this will be pre-populated based on the Bill’s session] Year: [this will be pre-populated based on the Bill’s year] Click the Save button From the Document menu, Generate a PDF |
| Able to edit values in the panel In the PDF generated in the next step, the List Number and Version appear in the footer  | | |
| 20 | Generate PDF of Lords Daily Sheet from the Official Lists tab Generating and viewing a PDF | Expand |
|---|
| From the Official Lists tab, click the Actions menu next to your Official List and select Generate PDF Ensure ‘Record snapshot version’ is ticked |
| PDF is generated and a green success toastie appears in the bottom-right of the screen The ‘View PDF’ button in the green success message can be clicked Clicking the ‘View PDF’ button opens the PDF in a new tab When you expand the snapshot versions under your list, there is a snapshot version labelled ‘PDF’ | | The user manual will need to be updated for v16 |
| 21 | Publish Lords Daily Sheet Publishing UK amendment lists (incl. ping pong lists) | Expand |
|---|
| From the Official Lists tab, click the Actions menu next to the PDF snapshot you generated Select Publish In the modal, click Publish |
| Publish version modal appears After confirming, a new significant version is created on the right-hand side Significant version’s label will be the version label of your list, prepended with the word ‘Published’ | | |
| 22 | Create Second Daily sheet with newly tabled amendments in it | Expand |
|---|
| On the Amendment Workspace tab, create a new LoDA; ensure Stage is set to ‘Committee’ Create one or two new amendments Save the list Expand the Amendment Status panel Click Bulk update statuses In the modal, select all amendments and choose to update from ‘Draft to Submitted’ Click Update and then Save the list Expand the Amendment Status panel again Click Bulk update statuses In the modal, select all amendments and choose to update from ‘Submitted to Tabled’ Click Update and then Save the list Close the Editor and return to the Official Lists tab Click Create and in the modal select ‘Lords Daily Sheet'; set Stage to ‘Committee of the Whole House’; set the cut-off date to today’s date and use a time slightly in the future for the cut-off time Click Create |
| A Lords Daily Sheet opens in the Editor The list contains only the amendments that weren't in the previous published list (i.e. just your new amendments) | | |
| 23 | Lords Daily sheet cut-off time test | Expand |
|---|
| On the Amendment Workspace tab, create a new LoDA; ensure Stage is set to ‘Committee’ Create one or two new amendments Save the list Expand the Amendment Status panel Click Bulk update statuses In the modal, select all amendments and choose to update from ‘Draft to Submitted’ Click Update and then Save the list Expand the Amendment Status panel again Click Bulk update statuses In the modal, select all amendments and choose to update from ‘Submitted to Tabled’ Click Update and then Save the list Close the Editor and return to the Official Lists tab Click Create and in the modal select ‘Lords Daily Sheet'; set Stage to ‘Committee of the Whole House’; set the cut-off date to today’s date and use a time in the past for the cut-off time (i.e. before you Tabled the amendments created in the previous steps) Click Create |
| A Lords Daily Sheet opens in the Editor The list does not contain the new amendments (because they were tabled after the cut-off time. | | |
| 24 | Add a note to Lords amendment Inserting an amendment note | Expand |
|---|
| Open one of the LoDAs created in the previous steps Right-click in the text of one of the amendments Select Insert Amendment Note |
| A placeholder note appears above the amendment Able to type text into the placeholder | | |
| 25 | Use filters on Amendment Manager tab Filtering amendments | Able to use the Quick Filter to filter on Amendment Status Able to use the main filter to filter on: LoDA name Dnum Location Member Status Comment text
| | |
| 26 | Generate and publish a Lords Running List Generating a Lords Running List | Expand |
|---|
| From the Official Lists tab Click Create and in the modal select ‘Lords Running List; set Stage to ‘Committee of the Whole House’; set the cut-off date to today’s date and use a time slightly in the future for the cut-off time In the Editor, from the Document menu, select Generate PDF and generate a PDF of the list Close the Editor On the Official Lists tab, expand the list of snapshots below your new Running List Click the Actions menu next to the PDF entry Select Publish |
| Editor opens showing the Running List Running List contains all amendments tabled so far (up until the cut-off date and time) Order of Consideration is listed in two columns on the first page After selecting ‘Publish’ from the Actions menu, the publish version modal appears After confirming, a new significant version is created on the right-hand side Significant version’s label will be the version label of your list, prepended with the word ‘Published’ | | |
| 27 | Create amendments to amendments in a new LoDA (to test the parsing of amendment text) [Commons and Lords] Amendments to amendments | Expand |
|---|
| On the Amendment Workspace tab, create a new LoDA; ensure Stage is set to ‘Committee’ In the Editor, press Enter to bring up the CCA and select Amendment to Amendment Use the following example text to populate the placeholders: (in the italic note) As an amendment to the amendment in the name of Lord Purvis of Tweed to Clause 5, page 2, line 33, printed on sheet HL Bill 128(a)
(in the instruction text) In subsection (6B) at end insert— Create another amendment-to-amendment and populate with the following example text: (in the italic note) As an amendment to the amendment in the name of Lord Purvis of Tweed to Schedule 3, page 112, line 33, printed on sheet HL Bill 128(a)
(in the instruction text) In schedule sub-paragraph (6B) at end insert "this is it" Create a third amendment-to-amendment and populate with the following example text: (in the italic note) As an amendment to amendment 2
(in the instruction text) In subsection (6B) at end insert "go for it" Save the list From the Amendment Information panel in the Editor, use the Bulk update statuses button to Submit and then Table the amendments |
| Able to create amendments to amendments After saving, the Amendment Information panel shows the following ‘Provision’ attribute for each amendment: first amendment: sec_5 second amendment: sch_3 third amendment amnd_2
Page and line numbers are also populated for the first two amendments | | |
| 28 | Create a Lords Marshalled List Generating a Lords Marshalled List | A Lords Marshalled List will open in the Editor containing all the tabled amendments The amendments will be numbered Amendments will be sorted according to the Lord's sort order; refer to the Manual for guidance: Sorting logic used by Lords amendment lists | | The user manual may need to be edited/updated |
| 29 | Update star status Inserting/removing an Amendment Star | Expand |
|---|
| With the Marshalled List open in the Editor Right-click the text of an amendment and select Update star status The system will present the Update amendment star dialogue box Select which star you want and click Update The system will update the amendment accordingly |
| Able to update star status from the modal Updated stars display in the Editor | | |
| 30 | Generate PDF of Lords Marshalled List and publish it Generating and viewing a PDF Publishing UK amendment lists (incl. ping pong lists) | Expand |
|---|
| On the Official Lists tab, from the Actions menu next to your Marshalled List, select Generate PDF and generate a PDF of the list; ensure ‘Record snapshot version’ is ticked Expand the list of snapshots below your Marshalled List Click the Actions menu next to the PDF entry Select Publish |
| PDF is generated and a green success toastie appears in the bottom-right of the screen The ‘View PDF’ button in the green success message can be clicked Clicking the ‘View PDF’ button opens the PDF in a new tab When you expand the snapshot versions under your list, there is a snapshot version labelled ‘PDF’ After selecting ‘Publish’ from the Actions menu, the publish version modal appears After confirming, a new significant version is created on the right-hand side Significant version’s label will be the version label of your list, prepended with the word ‘Published’ | | |
| 31 | Record outcomes against amendments using the Editor Recording outcomes (use Next/Previous buttons)| Status |
|---|
| colour | Greenamendment outcomesPass | 32 | Create another Daily Sheet (a supplementary sheet) | From the Amendment Manager tab, open a temporary list of all Tabled amendments In the Editor, expand the Amendment Status pane on the right Record outcomes against the amendments using the Next/Previous buttons and the Tabled/Rejected buttons |
| Able to use the Next and Previous buttons to choose between amendments in the list Able to use the Tabled and Rejected buttons Clicking Tabled or Rejected causes the button to become highlighted Able to click again on a highlighted button to deselect it; it becomes un-highlighted Clicking Save updates the Status (which is also visible in the Amendment Status pane) to show either ‘Tabled' or ‘Rejected’ depending on which button was highlighted when the save action was performed | | 33 | Create a Manuscript Amendment List | | 34 | Generate PDF of Manuscript List | | 35 | Publish Manuscript List |
|---|
| 32 | Create another Daily Sheet (a supplementary sheet) https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/64782398/Generating+a+Lords+Daily+Sheet+incl.+unnumbered+supplementary+sheets#Deciding-on-the-document-template-to-use%3A | New daily sheet opens in the Editor, in a new tab The supplementary ‘rubric’ appears in the Preface: [Supplementary to the Marshalled List] The list contains only new amendments tabled since the previous Marshalled List was published | | |
| 33 | Create a Manuscript Amendment List containing a new amendment Generating a Lords Manuscript List (used for numbered supplementary sheets) | Expand |
|---|
| On the Amendment Workspace tab, create a new Traditional LoDA Draft a simple amendment and save the list Submit the list Table the amendment; save and close the Editor From the Amendment Manager tab, select the amendment you just drafted Open the Amendment Actions menu and select ‘Create Official List’ In the modal, pick ‘Lords Manuscript List’ as the list type and Create the list |
| New List opens in the Editor, in a new tab The list contains the selected amendment Amendment is numbered Amendment will have a black star against it (because it was not published on an earlier list) | | |
| 34 | Generate PDF of Manuscript List and publish it Generating and viewing a PDF | Expand |
|---|
| On the Official Lists tab, from the Actions menu next to your Manuscript List, select Generate PDF and generate a PDF of the list; ensure ‘Record snapshot version’ is ticked Expand the list of snapshots below your Marshalled List Click the Actions menu next to the PDF entry Select Publish |
| PDF is generated and a green success toastie appears in the bottom-right of the screen The ‘View PDF’ button in the green success message can be clicked Clicking the ‘View PDF’ button opens the PDF in a new tab When you expand the snapshot versions under your list, there is a snapshot version labelled ‘PDF’ After selecting ‘Publish’ from the Actions menu, the publish version modal appears After confirming, a new significant version is created on the right-hand side Significant version’s label will be the version label of your list, prepended with the word ‘Published’ | | |
| 35 | Add additional text to the official Lords lists Inserting/deleting amendments or interstitial headings | Expand |
|---|
| Open a Daily, Marshalled, or Manuscript list in the Editor Use the CCA (by pressing Enter with your caret in the relevant place in the list) to do the following: Insert a paragraph in the title on the front and back cover Insert interstitial headings between amendments |
| Able to add new paragraphs to the front and back covers Able to add interstitial headings between amendments in the list | | |
| 36 | Applying amendments Applying Amendments | | | |
| 37 | Update cross references in amendments https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526373/Applying+Amendments#Cross-references-in-applied-amendments | | | |
| 38 | Prepare Bill "As Brought From Lords" Preparing a House Bill | Expand |
|---|
| From the Project tab, duplicate the last working version of your Bill From the Actions menu next to the duplicated version, select ‘Update document information’ Change the version rubric to "As amended at Committee" Generate a PDF of this version, and Publish that version Duplicate the version again, and label it ‘Commons copy’ or a similar title Generate another PDF, this time make sure ‘Generate as House Bill’ Share the working version with the House of Commons Login as a HoC user, duplicate the shared 'House Copy' Update the Document Information in the 'As Brought From the Lords' copy Generate a PDF and Publish the 'As brought from the Lords' copy |
| | | |
| 36 | Applying amendments (& resolving cross references) | | 37 | Prepare Bill "As Brought From Lords" | | 38 | OPC create LoDA for HoC amendments39 | OPC create LoDA for HoC amendments | Expand |
|---|
| Login to Lawmaker as an OPC user Open the UK Bill project On the Amendment Workspace tab, click New In the modal, pick Traditional type of amendment list Bill version: "as brought from the Lords" version House: "House of Commons" Stage: “Committee” Specify an unique List name and select a Proposer Click Create |
| Editor opens containing the draft list of amendments template And the Bill name will appear at the top of the template And the stage will match what I specified And the proposer will match what I specified And the list will be visible on the "Amendment Workspace" tab | | |
| 3940 | Create amendment cross references | | | |
| 4041 | OPC creates HoC amendment | | | |
| 4142 | Amend proposer and add supporters in Commons amendment | | | |
| 4243 | Generate PDF of Commons amendment LoDA with D Numbers | | | |
| 4344 | Set amendments to 'On hold' | | | |
| 4445 | OPC Submit Commons amendments (incl. flag & comment test) | | | |
| 4546 | HoC open submitted amendments in Ephemeral List | | | |
| 4647 | Save ephemeral list as LoDA | | | |
| 4748 | Copy and paste amendments in LoDA | | | |
| 4849 | Bulk Table Amendments | | | |
| 4950 | Bulk 'Ready for published' amendments | | | |
| 5051 | Duplicate a LoDA | | | |
| 5152 | Renumber amendments | | | |
| 5253 | Create Commons Marshalled List (incl. Update List) | | | |
| 5354 | Resolve x-refs | | | |
| 5455 | Update sort codes | | | |
| 5556 | Insert resolutions and motions and convert resolution to order | | | |
| 5657 | Create order of consideration for Commons amendments | | | |
| 5758 | Re-run 'Update List' in Commons Marshalled List | | | |
| 5859 | PDF Commons Marshalled list | | | |
| 5960 | Publish Commons Marshalled List | | | |
| 6061 | Duplicate last published Commons Marhsalled List | | | |
| 6162 | Re-run 'Update List' (having created more amendments & use white star) | | | |
| 6263 | Share Marshalled List with OPC | | | |
| 6364 | Recording outcomes (use Next/Previous buttons) | | | |
| 6465 | Generate a Commons Proceedings Document | | | |
| 6566 | Generate PDF of Commons Proceedings Document | | | |
| 6667 | Publish Commons Proceedings Document | | | |
| 6768 | Create another Commons Marshalled List | | | |
| 6869 | Applying amendments (& resolving cross references) | | | |
| 6970 | Re-open auto-save version on refresh | | | |
