Page Comparison

Dashboard

Dashboard displayed (or last tab associated with the project you last viewed)

Top-right menu on the dashboard shows that I am logged in with my username

Able to see projects that have been created by OPC users

Able to see projects that have a published Bill or Act in them from other organisations

Unable to see projects created by other organisations that do not have a published Bill in them

Open a document version in the Editor

Use the fold button in the toolbar, then use the Structure View to expand a particular provision

Folding provisions

	Test Case	Expected outcome	Pass / Fail	Tester’s Comments
1	Login to Lawmaker as an OPC user Overview of Lawmaker
Note
Status colour Green title Pass Status colour Red title Fail (delete as appropriate)
2	Create a New Bill Project Select UK Public Bill > Government Bill Creating a new project Note Ensure you include the word “Bill” at the end of the project/bill Title as a real bill would (this is necessary to test bill-to-act conversion later on in the script) Creating a new project Expand title Sub tests Can select: -types -sub-types -title	A new project is created, visible only to users in the same organisation as the current user It appears on the main Dashboard Project tab opens for the new document Editor opens in a new tab showing an empty template document	Status colour Green title Pass Status colour Red title Fail
3	Check and edit document information for the bill Bill using the Document Information panel in the Editor Managing document information Note Note that there is sometimes a delay between changing a value in this panel and the text changing in the main editor pane	Document information displays correctlyis updated in the main editor window Able to edit: Title, Session, Year, Rubric Details are changed or populated in the main editor pane after the change is made in the Doc Info panel
Status
colour	Green
Status colour Green title Pass Status colour Red title Fail
4	Create some content in the Editor using the CCA Inserting provisions and other elements Expand title Steps Click on the Body placeholder Press Enter on your keyboard to bring up the CCA Add a section and some sub-sections Build-up the Bill Structure by creating: Parts, Chapters, and Cross Headings , Sections, sub-sections, paragraphs . Also, create Create some other elements (eg: , like definitions , lists ) Tip You can copy and paste elements eg: create one part, with various sub elements and then copy to create more structure. You can copy text for your bill from http://legislation.gov.uk	CCA is displayed Creates Able to creates a realistic looking Bill within the Editor Structure view (left-hand side of the Editor window) is updated in line with new elements created in the Editor	Status colour Green title Pass Status colour Red title Fail
5	Insert 2 two or more schedules	The "SCHEDULES" heading will appear before the first schedule When inserting three or more schedules: If “Auto-renumbering” is OFF then schedules will not be renumbered  If “Auto renumbering” is ON then schedules will still not be renumbered (feels counter intuitive but is technically by design if not intention)	Status colour Green title Pass Status colour Red title Fail
6	Press Ctrl+S or click on the Save button Saving your document	A progress bar appears and progresses to 100% A message is displayed saying ‘Document Saved’ On the project tab, the version last modified is the same as the time it was saved	Status colour Green title Pass Status colour Red title Fail
7	Renumber the whole Bill Renumbering provisions Locking and unlocking numbers	All provisions will be renumbered sequentially including all their descendants. Note This action shouldn’t renumber any locked numbers, and those locked numbers will influence subsequent numbers	Status colour Green title Pass Status colour Red title Fail
8	Add one or more J-Refs to Sections or Schedules (v13) Managing J-refs	J-Refs are display displayed in the Editor in Red And the Each J-ref will be is also visible in the structure view	Status colour Green title Pass Status colour Red title Fail
9	Create cross reference(s) to sections that contain J-refs. Click Tag X-refs (v13) Cross-references (x-refs)	You can toggle on and off to display the J-ref in cross-references (Tools > Show/hide J-refs in cross references)	Status colour Green title Pass Status colour Red title Fail	10	Turn on Track Changes Using tracked changes Delete one or more elements / Insert element(s) and move element(s)	Inserted and deleted elements are display in the editor and blue (insert) or red (deleted)	Status colour Green title Pass Status colour Red title Fail	11	Insert a Table of Contents Inserting table of contents	Table of Contents is inserted at the start of the document "Front cover" appears in the Structure View	Status colour Green title Pass Status colour Red title Fail	12	Generate PDF Generating and viewing a PDF Ensure: Show tracked changes is ticked Select Side-lining Show J-Refs in margins Show J-Refs within cross references Deselect Record Snapshot Add Version Description (random text)	PDF is generated in separate tab Table of Contents is included Tracked changes are displayed in red for deleted text; blue for inserted text J-Refs are shown in margins J-Refs are shown with x-refs No snapshot is visible on the Project tab PDF Version is named using the text entered in the ‘Version description’ field References Expand title Steps Right-click on the provision in the Structure view you want to refer to (pick the section or schedule you labelled with a J-ref in the preceding step) From the context menu that appears, select the reference you want to copy from the Select x-ref to copy sub-menu. (The menu will show all the different options for referring to the provision so you can select whether or not you want to include the provision name - e.g. “section” - and whether any ancestor provisions should be included in the reference. This will place the selected cross-reference in the clipboard. To insert the reference, place your cursor in the Editor where you would like the cross reference to be inserted and press Ctrl+v to paste in the reference.	Able to copy a reference out of the structure view Able to paste a reference in another part of the document Able toggle on and off to display the J-ref in cross-references (from the toolbar: Tools > Show/hide J-refs in cross references) and these J-refs are then shown alongside the pasted cross references	Status colour Green title Pass Status colour Red title Fail
10	Turn on Tracked Changes Delete one or more elements, insert one or more elements, and move one or more elements Using tracked changes	Inserted and deleted elements are display in the editor and blue (insert) or red (deleted)	Status colour Green title Pass Status colour Red title Fail
11	Insert a Table of Contents Inserting table of contents	Table of Contents is inserted at the start of the document "Front cover" appears in the Structure View	Status colour Green title Pass Status colour Red title Fail
12	Generate a PDF Generating and viewing a PDF Ensure: ‘Show tracked changes’ is selected ‘Show J-Refs in margins’ is selected 'Show J-Refs within cross references' is selected Deselect ‘Record Snapshot’ Add a Version Description	PDF is generated in separate tab Table of Contents is included Tracked changes are displayed in red for deleted text; blue for inserted text J-Refs are shown in margins J-Refs are shown next to x-refs No snapshot is visible on the Project tab	Status colour Green title Pass Status colour Red title Fail
13	Make some more small changes in the Editor and then close the Editor using the Close button in the top-left	Prompted to Save changes	Status colour Green title Pass Status colour Red title Fail
14	Duplicate a document Duplicating a document version Expand title Tips Click the Actions menu next to a particular version Select ‘Duplicate’ In the modal, add a new folder and give the version a new name	New folder created with a duplicated version inside it	Status colour Green title Pass Status colour Red title Fail
15	Open a document version in the Editor Click the fold button in the toolbar, then use the Structure View to expand a particular provision Folding provisions Expand title Steps To test this in a realistic document, import a reasonably large Bill, such as this one: https://www.legislation.gov.uk/ukpga/2023/36/contents/enacted Steps for importing are here: Import legislation from www.legislation.gov.uk In the Editor, click the Fold button to collapse all provisions Now select a section from the structure view	The Editor will jump to the selected provision, and unfold it, showing the content Image Added	Status colour Green title Pass Status colour Red title Fail
16	Create a new working version Expand title Steps On the Project tab, click Document Actions Select Create New working version In the modal, create a new folder or select an existing folder Input a new name for the new version Click Create Use the CCA to add some sections to the new working version Save and close the editor	A new working version is created which appears on the 'Project' tab under the appropriate folder heading. Clicking on it to open it in the Editor will reveal an empty new document, allowing you to start drafting Able to save and close the new working version	Status colour Green title Pass Status colour Red title Fail
17	Edit Portion of a document Opening and editing a portion of document Expand title Steps From the Project tab Click the Actions menu next to one of the working versions you created in a previous step - it must have more than one provision in it for this test to be meaningful Select one or more provisions and they don’t need to be next to each other. All selected provisions must be at the same level so, for example, you can select a number of different sections dotted around a Bill, or you could select a couple of different Parts of an SI but you can’t select a cross-heading group and an individual section in a Bill. Note Renumber and tag/update x-refs will only be run over the provisions you have in the Editor - not the whole document in the backend.	The selected subset of provisions is opened in the Editor The highest level provisions e.g. sections, regulations or Parts, will have their numbers locked so that when you renumber the document, they do not get automatically updated	14	Close the Editor	Prompted to Save changes	Status colour Green title Pass Status colour Red title Fail	13	Delete the table of contents Expand title Tips Place your curser in the ToC Click on ToC on the Breadcrumb Press delete or backspace	Table of contents is removed	Status colour Green title Pass Status colour Red title Fail	Red title Fail
18	Close the Editor and Finalise the document Tick all options in the Finalise modal Finalising a document Info To test the ‘Renumber’ part of the Finalise action, you should randomly change the numbering of some of the provisions using the Editor and save the document	All provisions in the document, including provisions in quoted structures, are renumbered All existing cross references in the document are updated accordingly, including those within quoted structures If ‘Insert Front Cover’ is selected: any existing front cover is replaced, including the Table of Contents If ‘Insert Table of Contents’ is selected: any existing table of contents is replaced, but other parts of the front cover are left as they are	Status colour Green title Pass Status colour Red title Fail	15	Duplicate a document Expand title Tips Click the Actions menu next to a particular version Select ‘Duplicate’ In the modal, add a new folder and give the version a new name Documents and folders on the Project Tab
New folder created with a duplicated version inside it Note Documents and the folders on the 'Project' tab are now sorted alphanumerically. By default, folders will always be collapsed when you first open a project.	Status colour Green title Pass Status colour Red title Fail	16

The Editor will jump to the selected provision, and unfold it

Image Removed

Move a version to a new folder

https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/688786/Documents+and+folders+on+the+Project+Tab#How-to-move-a-working-version-to-another-folder

Selected version is moved to another existing folder or to the newly created folder specified in the modal

20

Share a version with the House of Commons

Sharing a document with another organisation

A Significant version of the Bill is created on the project tab

This version is also visible to HoC users

This version is not visible to users in other organisations

A new working version is created which will appear on the 'Project' tab under the appropriate folder heading.

Clicking on it to open it in the Editor will reveal an empty new document, allowing you to start drafting

Create a new working version

21

Login as a HoC user and navigate to the project created by OPC in previous steps

Dashboard displayed (or last tab associated with the project you last viewed)

Top-right menu on the dashboard shows that I am logged in with my username

Able to see projects that have been created by HoC users

Able to see projects that have a published Bill or Act in them from other organisations

Unable to see projects created by other organisations that do not have a published Bill in them

In the bill project created by OPC in previous steps, a significant version of the Bill is visible on the project tab with the same name as the original working version

18

Edit Portion of a document

Opening and editing a portion of document

The selected subset of provisions is opened in the Editor

AND the section or schedule nums are locked or grouping level nums (for body only - not in schedules)

Make a working copy of the significant version

A working version of the Bill is created, duplicating the content of the significant version

The new working version appears in the selected folder or newly created folder (with the name specified in the modal)

Able to open and edit the new working version

Close the Editor and Finalise the document

Finalising a document

Assuming you selected all options:

All provisions in the document, including provisions in quoted structures, are renumbered

All existing cross references in the document and update them accordingly - including those within quoted structures

If Insert Front Cover is selected: any existing front cover is replaced, including the Table of Contents

Mark sections/schedule paragraphs/subsections/schedule sub-paragraphs in a UK Bill as a "money provision" so that it (and all its descendants) is rendered in italics in the Editor and PDF

Marking 'money provisions'

Able to set provisions as money provisions

Money provisions should appear italic in the Editor and in the generated PDF

Descendants of those provisions also display in italics

Move a version to a new folder

Documents and folders on the Project Tab

24

Update document information for the new working version

Managing document information

Example details to add/change:

Session: 58/1, Bill year: 2021, Bill number: Bill 221, version rubric: "As introduced", printed by: "House of Commons"

Bill title and version rubric are updated in the editor, corresponding to the changes made in the Doc Info panel

On the Dashboard showing all projects, Bill number and session are updated

Share a version with the House of Commons

Sharing a document with another organisation

A Significant version of the Bill is created on the project tab

This version is also visible to HoC users

This version is not visible to users in other organisations

Login as a HoC user

Dashboard displayed (or last tab associated with the project you last viewed)

Top-right menu on the dashboard shows that I am logged in with my username

Able to see projects that have been created by HoC users

Able to see projects that have a published Bill or Act in them from other organisations

Manage proposers and supporters on a Bill in the Editor

Managing document information

Able to add and remove proposers and supporters

Able to change the order of names by dragging and dropping in a different order

Open the project created by OPC in previous steps

A significant version of the Bill will appear on the project tab with the same name as the original working version

26

Add Back cover to the Bill

Inserting UK Bill and Act front and back covers

Back cover will be inserted at the end of the Bill in the Editor

The back cover shows the Bill is being introduced by the proposer

The back cover shows the Bill is being supported by the supporters

The back cover shows the introduction date

Make a working copy of the significant version

A working version of the Bill is created, duplicating the content of the significant version

The new working version appears in the selected folder or newly created folder (with the name specified in the modal)

Able to open and edit the new working version

27

Re-insert the Back cover after changing proposers and supporters and updating the printed date

Back cover is reinserted and replaces the existing one

Proposers/supporters names are updated

The printed date is updated

Mark sections/schedule paragraphs/subsections/schedule sub-paragraphs in UK Bill as "money provision" so that it (and all its descendants) is rendered in italics in the Editor and PDF

Marking 'money provisions'

Able to set provisions as money provisions

Money provisions should appear italic in the Editor and in the generated PDF

28

Insert a Front cover

Inserting UK Bill and Act front and back covers

Front cover shows the Bill title in the editor

Any existing Table of Contents is replaced with an up-to-date Table of Contents

Update document information for the new working version

Example details to add/change:

Session: 58/1, Bill year: 2021, Bill number: Bill 221, version rubric: "As introduced", printed by: "House of Commons"

Managing document information

Bill title and version rubric are updated in the editor, corresponding to the changes made in the Doc Info panel

On the Dashboard showing all projects, Bill number and session are updated

29

Generate a PDF of the Bill with changes applied, line numbering, and footers; include a footer note; ensure ‘Record snapshot version’ is ticked

Generating and viewing a PDF

PDF opens in new tab

The PDF contains line numbering and footers

Footer note text is correct

Output PDF shows changes applied

Manage proposers and supporters on a Bill in the Editor

Managing proposers and supporters on inline amendments

Able to add and remove proposers and supporters

Able to change the order of names by dragging and dropping in a different order

30

Publish a significant version of the generated PDF

Publishing a Bill document version

Significant version created on the right-hand side of the Project tab

Significant version visible to users in other organisations

Copy of the Bill is accessible through the PDR API

Add Back cover to the Bill

Inserting UK Bill and Act front and back covers

Back cover will be inserted at the end of the Bill in the Editor

And the back cover will show the Bill is being introduced by the proposer

And the back cover will show the Bill is being supported by the supporters

31

Create an ‘as amended’ folder and version by duplicating the published version

New working version with the specified name in the specified folder is created

2932

Open the newly created ‘as amended’ version in the Editor and change some Document Information:

Change the ‘printed' date

Update the document rubric to ‘as amended in Committee’

Re-insert the Back cover after changing proposers and supporters and updating the printed date

Back cover is reinserted and replaces the existing one

And proposers/supporters names are updated

And the printed date is updatedfront and back covers

Save and close the Editor

Able to update the document information from the Editor

Text shown in the main Editor pane updates accordingly

Text on the front and back covers is updated accordingly

Insert a Front cover

Inserting UK Bill and Act front and back covers

Front cover shows the Bill title in the editor

Any existing Table of Contents is replaced with an up-to-date Table of Contents33

Generate a PDF and publish the ‘as amended’ version

Significant version created on the right-hand side of the Project tab

Significant version visible to users in other organisations

Copy of the Bill is accessible through the PDR API

3134

Generate a PDF of the Bill with line numbering and footers; include a footer note

Generating and viewing a PDF

PDF opens in new tab

And the PDF contains line numbering and footers

Footer note text is correctthe House Bill

Preparing a House Bill​

Able to generate a House Bill

First page of the PDF shows the year, bill short title and long title with appropriate styling

Image Added

Publish a significant version of the generated PDF

Publishing a Bill document version

35

Share a new copy with the House of Lords

Sharing a document with another organisation

Significant version created on the right-hand side of the Project tabTab

Significant version visible to users in other organisationsCopy of the Bill accessible through the PDR APIlabel will start with the word ‘Shared’

Create an ‘as amended’ folder by duplicating a version

New working version with the specified name in the specified folder is created36

Login as a HoL user, navigate to the same project, and Duplicate a version of this shared copy to create a new working version

Able to create a new working version in the folder you specify in the modal

Version label has the name you specified in the modal

Open the newly created ‘as amended’ version in the editor and change some Document Information:

Change the ‘printed' date

Update the document rubric

Re-insert the front and back covers

Text shown in the main Editor pane update accordingly

Text on the front and back covers is updated accordingly

Share a new copy with the House of Lords

Sharing a document with another organisation

37

Update the Document information from the Actions menu on the Project Tab to make this the “as brought from the Commons” version

Specify a Bill number, e.g. HL Bill 29

Specify a ‘brought from’ date

Specify that it is printed by the House of Lords

All changes are possible in the modal

Clicking Update works as expected

When opening the document in the Editor, new document information is visible (you may have to re-insert the front and back covers - see next step)

38

Open this version in the Editor and reinsert the front and back covers

Able to reinsert the front and back covers

Back cover shows correct version rubric and brought from/printed by dates

Image Added

3639

Login as a HoL user, navigate to the same project, and Duplicate a version of this shared copy to create a new working version

Able to create a new working version in the folder you specified in the modal

Version label has the name you specified in the modalGenerate a PDF of this version and then create a Significant version

Generating and viewing a PDF Publishing a Bill document version

Able to generate PDF

Able to select Publish version from the Actions menu next to the PDF snapshot

Warning modal is displayed

On clicking Publish, a new significant version is created on the right-hand side of the Project Tab

Version is accessible through the PDR API with the correct House and docType values

Update the Document information from the Actions menu on the Project Tab to make this the “as brought from the Commons” version

Specify a Bill number, e.g. HL Bill 29

Specify a ‘brought from’ date

Specify that it is printed by the House of Lords

Update the Proposer and Supporter info

All changes are possible in the modal

Clicking Update works as expected

40

Create an ‘as amended’ folder by duplicating a version

New working version with the specified name in the specified folder is created

Able to generate PDF

Able to select Publish from the Actions menu next to the PDF snapshot

Warning modal is displayed

On clicking Publish, a new significant version is created on the right-hand side of the Project Tab

Version is accessible through the PDR API with the correct House and docType values

Generate a PDF of this version and then create a Significant version

Generating and viewing a PDF Publishing a Bill document version

41

Open the newly created ‘as amended’ version in the editor and change some Document Information:

Change the ‘printed' date

Update the document rubric

Re-insert the front and back covers

Text shown in the main Editor pane update accordingly

Text on the front and back covers is updated accordingly

3942

Create an Act version of the Bill

Converting a UK Bill into an Act

New working version created containing an Act version of the bill

Open this new version in the Editor and change some Document Information

an Act version of the Bill

Converting a UK Bill into an Act

New working version created containing an Act version of the bill

Act title is correct

Text on the cover and preface change accordingly in the main Editor pane

4143

Generate a PDF of this Act version; ensure ‘Record snapshot’ is ticked

PDF snapshot is generated

4244

Submit the Act to TNA

Submitting a UK Act to TNA

From the Actions menu next to the PDF snapshot, select ‘Submit to TNA’

Warning is displayed, with Submit and Cancel buttons

On clicking Submit, a new Significant version is created

The Act is available through the PDR API

4345

Download a ZIP of the Act and resolve dates in the XML

Downloading a ZIP file of a document

Able to download a ZIP of the Act

ZIP contains the Act XML, PDF, and any images

4446

4547

4648