Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Test Case

Expected outcome

Pass / Fail

Tester’s Comments

1

Login to Lawmaker as an OPC user

Overview of Lawmaker

Note

Dashboard Functionality is tested in other scripts

Dashboard displayed (or last tab associated to 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

Status
colourGreen
titlePass
Status
colourRed
titleFail
(delete as appropriate)

2

Create a New Project

Select UK Public Bill > Government Bill

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
titleSub 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
colourGreen
titlePass
Status
colourRed
titleFail

3

Check and edit document information for the 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 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

Status
colourGreen
titlePass
Status
colourRed
titleFail

4

Manage members on a bill

Add a proposer and supporters to the Bill (using the manage members modal which is accessible from the Doc Info panel)

Proposer and supporters will be stored in the Bill

Status
colourGreen
titlePass
Status
colourRed
titleFail

5

Add Back cover to the Bill

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

And the back cover will show the introduction date

Status
colourGreen
titlePass
Status
colourRed
titleFail

6

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)

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 a realistic looking Bill

Structure view (left-hand side of the Editor window) is updated in line with new elements created in the Editor

Status
colourGreen
titlePass
Status
colourRed
titleFail

7

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) 

Status
colourGreen
titlePass
Status
colourRed
titleFail

8

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

Status
colourGreen
titlePass
Status
colourRed
titleFail

9

Renumber the whole Bill

Renumbering provisions

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
colourGreen
titlePass
Status
colourRed
titleFail

10

Add one or more J-Refs to Sections or Schedules

(v13) Managing J-refs

J-Refs are display in the Editor in Red

Image Added

And the J-ref will be visible in the structure view

Status
colourGreen
titlePass
Status
colourRed
titleFail

Image Removed

11

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
colourGreen
titlePass
Status
colourRed
titleFail

12

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
colourGreen
titlePass
Status
colourRed
titleFail

13

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
colourGreen
titlePass
Status
colourRed
titleFail

When I choose to insert a table of contents
Then a table of contents will appear in the Editor
And "Front cover" will appear in the structure view

14

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 names as per named using the text entered .in the ‘Version description’ field

Status
colourGreen
titlePass
Status
colourRed
titleFail

Image Removed

15

Deleting a table of contents

Expand
titleTips

Place your curser in the ToC

Click on ToC on the Breadcrumb

Press delete or backspace

Table is removed.

Status
colourGreen
titlePass
Status
colourRed
titleFail

16

Close the Editor

Prompted to Save changes

Status
colourGreen
titlePass
Status
colourRed
titleFail
Changes are saved

17

Duplicate a document

Expand
titleTips

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
colourGreen
titlePass
Status
colourRed
titleFail

18

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

Expand
titleSteps

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

fold button

Status
colourGreen
titlePass
Status
colourRed
titleFail

19

Create a new working version

Expand
titleSteps

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
colourGreen
titlePass
Status
colourRed
titleFail

20

Edit Portion of a document

Opening and editing a portion of document

Note
  1. You can't select different hierarchical levels (e.g. a whole part and a section from another part) - instead you need to select both parts or only select the sections from each part that you need to edit.

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

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

Status
colourGreen
titlePass
Status
colourRed
titleFail

21

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

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

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
colourGreen
titlePass
Status
colourRed
titleFail

22

Move a version to a new folder

Documents and folders on the Project Tab

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

Status
colourGreen
titlePass
Status
colourRed
titleFail

23

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

Status
colourGreen
titlePass
Status
colourRed
titleFail

24

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
colourGreen
titlePass
Status
colourRed
titleFail

25

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
colourGreen
titlePass
Status
colourRed
titleFail

26

Make a working copy of the significant version

Expand
titleSteps

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 folder selected or created in the ‘Duplicate version’ modal

Status
colourGreen
titlePass
Status
colourRed
titleFail

27

28

29

30

31

32