Test Case | Expected outcome | Pass / Fail | Tester’s Comments | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | Login to Lawmaker as an OPC 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 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 |
| ||||||||||||||||||||
2 | Create a New Project Select UK Public Bill > Government Bill
| 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 |
| ||||||||||||||||||||
3 | Check and edit document information for the bill using the Document Information panel in the Editor
| Document information displays correctly 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 |
| ||||||||||||||||||||
4 | Click on Body placeholder Build-up the Bill Structure by creating: Parts, Chapters, Cross Headings, Sections, sub-sections, paragraphs. Also, create some other elements (eg: definitions , lists)
| CCA is displayed Creates a realistic looking Bill Structure view (left-hand side of the Editor window) is updated in line with new elements created in the Editor |
| ||||||||||||||||||||
5 | Insert 2 schedules | The "SCHEDULES" heading will appear before the first schedule If “Auto-renumbering” is OFF then schedules will not be renumbered If “Auto renumbering” is ON then schedules will not be renumbered (feels counter intuitive but is technically by design if not intention) |
| ||||||||||||||||||||
6 | Press Ctrl+S or click on the Save button | 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 |
| ||||||||||||||||||||
7 | Renumber the whole Bill | All provisions will be renumbered sequentially including all their descendants.
|
| ||||||||||||||||||||
8 | Add one or more J-Refs to Sections or Schedules (v13) Managing J-refs | J-Refs are display in the Editor in Red And the J-ref will be visible in the structure view |
| ||||||||||||||||||||
9 | Create cross reference(s) to sections that contain J-refs. Click Tag X-refs | You can toggle on and off to display the J-ref in cross-references (Tools > Show/hide J-refs in cross references) |
| ||||||||||||||||||||
10 | Turn on Track Tracked ChangesUsing 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) |
| ||||||||||||||||||||
11 | Insert a Table of Contents | Table of Contents is inserted at the start of the document "Front cover" appears in the Structure View |
| ||||||||||||||||||||
12 | Generate PDF Ensure:
| 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 |
| ||||||||||||||||||||
13 | Delete the table of contents expandClose the Editor | Prompted to Save changes |
| Tips | |||||||||||||||||||
Place your curser in the ToC Click on ToC on the Breadcrumb Press delete or backspace | Table of contents is removed |
| |||||||||||||||||||||
14 | Close the Editor | Prompted to Save changes |
| 15 | Duplicate a document Expand | | |||||||||||||||||
|
Expand | ||
---|---|---|
| ||
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 | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Open a document version in the Editor
Use the fold button in the toolbar, then use the Structure View to expand a particular provision
Expand | ||
---|---|---|
| ||
Import a reasonably large Bill: https://www.legislation.gov.uk/ukpga/2023/36/contents/enacted 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
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Create a new working version
Expand | ||
---|---|---|
| ||
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 |
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
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Edit Portion of a document
Opening and editing a portion of document
Note |
---|
|
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)
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Close the Editor and Finalise the document
Info |
---|
To test the ‘Renumber’ part of the Finalise action, you should randomly renumber some of the provisions using the Editor and save the 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
If you select Insert Table of Contents: any table of contents if there is one but will leave other parts of the front cover as they are.
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Move a version to a new folder
Selected version is moved to another existing folder or to the newly created folder specified in the modal
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Share a version with the House of Commons
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
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
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
Unable to see projects created by other organisations that do not have a published Bill in them
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
From the dashboard, search for and 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
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Make a working copy of the significant version
Expand | ||
---|---|---|
| ||
Use the Actions menu next to the Significant version Select Duplicate version Choose a folder name Choose a version name Click Create |
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
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
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
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
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
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"
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
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Manage proposers and supporters on a Bill in the Editor
Able to add and remove proposers and supporters
Able to change the order of names by dragging and dropping in a different order
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Add Back cover to the Bill
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
And the back cover will show the introduction date
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
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 updated
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Insert a Front cover
Front cover shows the Bill title in the editor
Any existing Table of Contents is replaced with an up-to-date Table of Contents
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Generate a PDF of the Bill with line numbering and footers; include a footer note
Expand | ||
---|---|---|
| ||
Make sure there are some track changes edits in the version of the Bill In the ‘Generate PDF’ modal, select ‘show changes applied’ Confirm that output PDF shows changes applied |
PDF opens in new tab
And the PDF contains line numbering and footers
Footer note text is correct
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Publish a significant version of the generated PDF
Significant version created on the right-hand side of the Project tab
Significant version visible to users in other organisations
Copy of the Bill accessible through the PDR API
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Create an ‘as amended’ folder by duplicating a version
Expand | ||
---|---|---|
| ||
Using the Actions menu next to a version on the Project tab, select Duplicate version Create a new folder (“Committee”“As Amended in Committee”) and give the version a label (“as amended”) Tick the option which removes page/line numbers |
New working version with the specified name in the specified folder is created
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
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
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Share a new copy with the House of Lords
Sharing a document with another organisation
Expand | ||
---|---|---|
| ||
Duplicate a version of the Bill Specify a version name (“Lords copy 1”) and folder (“Lords copy”) Strip out page and line numbering From the Actions menu next to the new version, select Share version In the modal, select the House of Lords |
Significant version created on the right-hand side of the Project Tab
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
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 modal
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
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 LordsUpdate the Proposer and Supporter info
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)
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Generate a PDF of this version and then create a Significant version
Generating andOpen 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
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Generate 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 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 TabVersion is accessible through the PDR API with the correct House and docType valuescreated on the right-hand side of the Project Tab
Version is accessible through the PDR API with the correct House and docType values
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Create an ‘as amended’ folder by duplicating a version
Expand | ||
---|---|---|
| ||
Using the Actions menu next to a version on the Project tab, select Duplicate version Create a new folder (“As Amended in Committee”) and give the version a label (“as amended”) Tick the option which removes page/line numbers |
New working version with the specified name in the specified folder is created
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
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
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Create an Act version of the Bill
New working version created containing an Act version of the bill
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Open this new version in the Editor and change some Document Information
Expand | ||
---|---|---|
| ||
Check the Act Title is correct Update Year, Chapter number and Assent date Save the document |
Act title is correct
Text on the cover and preface change accordingly in the main Editor pane
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Generate a PDF of this Act version
PDF snapshot is generated
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Submit the 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
Act is available through the PDR API
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Download a ZIP of the Act and resolve dates in the XML
Able to download a ZIP of the Act
ZIP contains the Act XML, PDF, and any images
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|