Document toolboxDocument toolbox

UK Amendments Test Script (Lords starter)

Test Case

Expected outcome

Pass / Fail

Tester's Comments

Test Case

Expected outcome

Pass / Fail

Tester's Comments

1

As an OPC user, setup a test Bill project

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; include some real text and full sentences in those sections and schedule paragraphs so you can test the application of amendments later in the script

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

 

Pass Fail (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)

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

Pass Fail

 

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

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 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

Pass Fail

 

4

Share the Bill with the House of Lords Sharing a document with another organisation

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)

Pass Fail

 

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

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

Pass Fail

 

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

Pass Fail

 

7

As an OPC user, turn on/off line numbering for amendments

Turn on/off line number on amendments (including ping pong motions)

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

Pass Fail

 

8

As an OPC user, change the Proposer of a Lords amendment and add supporters

Managing document information

Able to bring up the Manage Proposers and Supporters modal

Able to search for and select names in both fields

Both drop-down lists contain suggestions for Lords names

On clicking Update, chosen names appear in the main Editor window above the relevant amendment

Pass Fail

 

9

As an OPC user, place some amendments On Hold

Set 'Draft' amendments to 'On hold' (and vice versa)

Able to put amendments On Hold

Unable to Submit an amendment which is On hold

Pass Fail

 

10

As an OPC user, generate PDF of Lords amendment LoDA with D-Numbers

Generating and viewing a PDF

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

Pass Fail

 

11

As an OPC user, Submit Lords amendments from the LoDA

Submitting 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

Pass Fail

 

12

As a HoL user, view submitted Lords amendments in ephemeral list

Opening amendments in the Editor (creating temporary lists)

Editor opens, showing the selected amendments

The amendments are editable

Pass Fail

 

13

Table and Reject amendments from the ephemeral list

Tabling UK amendments (incl. 'ready for publishing')

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

Pass Fail

 

14

Bulk update the other amendments' statuses

Tabling UK amendments (incl. 'ready for publishing') | To update statuses in one go

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'

Pass Fail

 

15

Update Lifecycle Event for one of the amendments

Undoing an amendment status/managing lifecycle events

The status of the selected amendment (in the Amendment Information panel) changes to ‘Submitted’

Pass Fail

 

16

Create Lords Daily Sheet

Generating a Lords Daily Sheet (incl. unnumbered supplementary sheets)

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: https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/64651345

Pass Fail

 

17

Move an amendment on a Lords Daily Sheet using the Structure View

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/9339303

Editor is updated showing the amendment in the new location

Structure view also updates

Pass Fail

 

18

Create an Order of Consideration for Lords amendments

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526399

To test this functionality, some of the amendments you created in earlier steps must refer to numbered clauses and schedules.

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

Pass Fail

 

19

Sort amendments by Order of Consideration on the 'Amendment Manager' tab

Amendments are sorted in the list according to the OoC

Pass Fail

 

20

Update Daily Sheet Document Information 

Managing document information

Able to edit values in the panel

In the PDF generated in the next step, the List Number and Version appear in the footer

image-20240116-085748.png

 

Pass Fail

 

21

Generate PDF of Lords Daily Sheet from the Official Lists tab

Generating and viewing a PDF

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’

 

Pass Fail

The user manual will need to be updated for v16

22

Publish Lords Daily Sheet

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/60456974

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’

Pass Fail

 

23

Create Second Daily sheet with newly tabled amendments in it

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)

Pass Fail

 

24

Lords Daily sheet cut-off time test

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.

Pass Fail

 

25

Add a note to Lords amendment

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526485

A placeholder note appears above the amendment

Able to type text into the placeholder

Able to save the list

Pass Fail

 

26

Use filters on Amendment Manager tab

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526453

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

Pass Fail

 

27

Generate and publish a Lords Running List

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/65961985

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’

 

Pass Fail

 

28

Create amendments to amendments in a new LoDA (to test the parsing of amendment text)

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/60653569

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

Pass Fail

 

29

Create a Lords Marshalled List

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/65961999

A Lords Marshalled List opens in the Editor containing all the tabled amendments

The amendments are numbered

Amendments are sorted according to the Lord's sort order; refer to the Manual for guidance: https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/64651345

Pass Fail

The user manual may need to be edited/updated

30

Update star status

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526509

Able to update star status from the modal

Updated stars display in the Editor

Pass Fail

 

31

Generate PDF of Lords Marshalled List and publish it

Generating and viewing a PDF https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/60456974

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’

Pass Fail

 

32

Record outcomes against amendments using the Editor

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/60948519

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

Pass Fail

 

33

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

Pass Fail

 

34

Create a Manuscript Amendment List containing a new amendment

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/65994753

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)

Pass Fail

 

35

Generate PDF of Manuscript List and publish it

Generating and viewing a PDF

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’

Pass Fail

 

36

Add additional text to the official Lords lists

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526493

Able to add new paragraphs to the front and back covers

Able to add interstitial headings between amendments in the list

Able to save the list

Pass Fail

 

37

Applying amendments as a Lords user

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526373

Green success toastie appears in top-right of the screen

Number of amendments successfully applied is stated in the toastie

On the Project Tab, a new bill version exists in the chosen folder with the label you specified

When opening that version in the Editor, you can expand the Inline amendments pane and Review pane on the right-hand side to see successful and failed amendments

If one or more amendments were successfully applied, the bill version contains red and blue tracked change markup showing the changes made by those amendments

If one or more amendments were successfully applied, there is an ‘Accept All’ button at the top of the list in the Inline amendments panel

Clicking ‘Accept all’ applies the amendments to the bill text and removes the red and blue tracked changes

Pass Fail

 

38

Update cross references in amendments

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526373/Applying+Amendments#Cross-references-in-applied-amendments

Able to resolve cross-references in applied amendments

Pass Fail

 

39

Create the ‘As amended in Committee’ version and publish it

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’

 

 

40

Prepare the "As Brought From Lords" version

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/63406081

Able to share version between HoL and HoC

Able to add Brought from date

Able to change ‘Printed by’ value to House of Commons

Able to update the front and back covers in the Editor

Version rubric shows [As brought from the Lords]

Able to generate a PDF and publish it

Pass Fail

 

41

As an OPC user, create a new LoDA against the As Brought from the Lords version

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 against the As brought from the Lords workspace filter

Pass Fail

 

42

As an OPC user, create some amendments in the LoDA

Drafting and editing amendments https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/65011715

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 Commons amendments can be found in this PDF: Commons PBC amendments to the Digital Markets Bill

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 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

Pass Fail

 

43

Duplicate a LoDA

List is duplciated and appears on the Amendment workspace tab against the same bill version

Abe to open the new list in the Editor

List contains the same amendments from the copied list, including Dnums

Pass Fail

 

44

Amend proposer and add supporters in Commons amendment

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526541

Able to update proposer and supporter information for amendments drafted in the LoDA

In the Manage members modal, both drop-down lists contain suggestions for Commons MPs' names

Able to save the list

Pass Fail

 

45

As an OPC user, generate PDF of Commons amendment LoDA with D-Numbers

Generating and viewing a PDF

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

Pass Fail

The user manual will need to be updated for v16

46

As an OPC user, Submit Commons amendments from a LoDA; in the Submit amendments modal mark them as ‘Government amendments’

Also test commenting on amendments and flagging amendments

Submitting amendments https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/115343371 https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526461

Able to submit amendments from the LoDA

 

Pass Fail

 

47

As a HoC user, open submitted amendments in an Ephemeral List

Able to view OPC amendments in the Amendment Manager tab

Able to open the amendments in a temporary list

Pass Fail

 

48

Save ephemeral list as LoDA

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526637

Able to save the temporary list as a LoDA with a new label

Saved LoDA is visible on the Amendment Workspace tab

Pass Fail

 

49

Copy and paste amendments in LoDA

Amendment is pasted as a new amendment, with no D-num assigned to it

Able to save the list

Pass Fail

 

50

Bulk Table Amendments

Tabling UK amendments (incl. 'ready for publishing') | To update statuses in one go

Able to table all amendments in the LoDA

Pass Fail

 

51

Bulk update status of amendments to ‘Ready for publishing’

Tabling UK amendments (incl. 'ready for publishing') | To update statuses in one go

Able to mark all amendments in the LoDA as ‘Ready for publishing'

Pass Fail

 

52

Renumber amendments in the LoDA

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526629

Able to renumber amendments from the specified starting number in the Editor

OPC amendments which were marked as government amendments will have Gov before their number

Pass Fail

 

53

Create Commons Marshalled List and Update the list

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/30212099

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/23199745

Empty Marshalled List opens in the Editor, in a new tab

Relevant rubrics are present at the start of the List; compare with this PDF: digitalmarkets_day_pbc_0711.pdf (parliament.uk)

On clicking ‘Update list’, all amendments marked ‘Ready for publishing’ are added to the list and can be viewed in the editor

Pass Fail

 

54

Insert resolutions and motions and convert resolution to order

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526501

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526381

Able to use the CCA in the Editor to insert resolutions into the list

Able to use the CCA in the Editor to insert motions into the list

Converting a resolution into an Order removes it from the list and a new order (containing the resolution content) is inserted at the end of the amendment list (before the Withdrawn Amendment section)

Able to save the list

Pass Fail

 

55

Create order of consideration for Commons amendments

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526399

Able to create an Order of Consideration from the modal

Pass Fail

 

56

Create some new amendments and then re-run 'Update List' in the Commons Marshalled List

New amendments are added to the Marshalled list

Amendments which appear in the updated Marshalled list are marked with a black star

Able to save the list

Pass Fail

 

57

Generate a PDF of a Commons Marshalled list; ensure ‘Record snapshot version’ is ticked

Generating and viewing a PDF

Able to generate a PDF

Check PDF formatting: compare with digitalmarkets_day_pbc_0615.pdf (parliament.uk)

Pass Fail

 

58

Publish Commons Marshalled List

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/60456974

Able to publish the list

New significant version is created on the Official Lists tab

Pass Fail

 

59

Duplicate last published Commons Marshalled List

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526440

Able to duplicate the list

Second marshalled list is visible on the Official Lists tab and can be opened in the Editor

Pass Fail

 

60

Re-run 'Update List' to test the white star functionality

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526698

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/23199745/House+of+Commons+amendment+list+logic#Starred-amendments

White star appears next to all amendments in the list

The PDF version displays the white stars against the same amendments

 

Pass Fail

 

61

Share Marshalled List with OPC

Sharing a document with another organisation

Significant version created on the Official Lists tab after sharing

New significant version is visible to OPC users

Pass Fail

 

62

Recording outcomes (use Next/Previous buttons)

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/60948519

Able to navigate between amendments in the list using the Next and Previous buttons

Able to update the outcome of each amendment using the buttons

After clicking the button, the decision block displays that outcome

Able to change the text in the decision block by typing into the 'decision' field on the right-hand panel

On saving, the changes are saved

Pass Fail

 

63

Generate a Commons Proceedings Document

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526477

Empty Proceedings document opens in the Editor, in a new tab

Relevant rubrics are present at the start of the List; compare with this PDF: digitalmarkets_rpro_pbc_0711 (parliament.uk)

On clicking ‘Update list’, all amendments with outcomes recorded against them are added to the list and can be viewed in the Editor

Pass Fail

 

64

Generate PDF of Commons Proceedings Document; ensure ‘Record snapshot version’ is ticked

Generating and viewing a PDF

Able to generate a PDF of the Proceedings document

Pass Fail

 

65

Publish Commons Proceedings Document

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/60456974

Able to publish the Proceedings document

New Significant version created on the Official Lists tab

Pass Fail

 

66

Create another Commons Marshalled List, to test that amendments with outcomes recorded against them are no longer included

On creating the list and updating it, amendments with outcomes recorded against them are not included

Pass Fail

 

67

Applying amendments as a Commons user

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/25526373

Green success toastie appears in top-right of the screen

Number of amendments successfully applied is stated in the toastie

On the Project Tab, a new bill version exists in the chosen folder with the label you specified

When opening that version in the Editor, you can expand the Inline amendments pane and Review pane on the right-hand side to see successful and failed amendments

If one or more amendments were successfully applied, the bill version contains red and blue tracked change markup showing the changes made by those amendments

If one or more amendments were successfully applied, there is an ‘Accept All’ button at the top of the list in the Inline amendments panel

Clicking ‘Accept all’ applies the amendments to the bill text and removes the red and blue tracked changes

Pass Fail