Versions Compared

Key

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

Taken to the dashboard
And it will show that I am logged in with my username

I will be able to see projects that have been created by PCO users

I will be able to see projects that have a published Bill or Act in them from other organisations

I will not be able to see projects created by other organisations that do not have a published Bill in them

Dashboard Functionality is tested in other scripts56789101112

Test Case

Expected outcome

Pass / Fail

Tester’s Comments (delete existing text as you complete each step and leave a comment with repro steps if you find a bug)

1

Login into to Lawmaker as a PCO user

Overview of LawmakerProjects and documents

Note

Dashboard Functionality is tested in other scripts

Dashboard displayed or last tab associated to the project you last viewed.

Projects and documents

Status
colourGreen
titlePass
/
Status
colourRed
titleFAIL
Note

Status
colourGreen
titlePass

Passed; permissions look good too - I can see PCO-created docs and Bill/Act docs with significant versions in the project

2

Create a New Project

Select Scottish Public Bill > Government Bill

Creating a new project

Expand
titleSub tests

Can select different:

types

>types

sub

>sub-types

  • Enter title

  • Create a Scottish Public Bill / Government

    Click Create

    Image Removed

    3

    Editor Opens

    ‘Empty’ document is displayed in the Editor

    An empty Bill template will shown in the Editor
    And the document information panel will be updated accordingly
    And the name of the Bill will show in the Editor
    And a new Bill project will be created on the dashboard
    And the project will not be visible to users in another organisation

    AND I can go back into the Bill and change the short title, with the Short title at the top automatically updating when I edit 'Title' in the Doc Info panel

    4Click on Body

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

    Status
    colourGreen
    titlePass

    3

    Check and edit document information for the bill using the Document Information panel in the Editor

    Add an Introduction Date

    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

    Passed (although note note the general slowness after updating details in the various Doc Info fields - expected behaviour)

    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)

    Manage Members modal displays

    Able to search for SP members in the ‘Proposer’ and ‘Supporter’ fields

    Able to pick names from the dropdown list

    Able to click Update to add the members to the bill

    Able to click Cancel to close the modal without saving changes

    Status
    colourGreen
    titlePass

    Pass - note that by default when no text has been entered in these fields then the drop-down just says ‘No results found’

    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

    6

    Click on Body placeholder

    Build-up the Bill Structure by creating: Parts, Chapters, Cross Headings, Sections, sub-sections, paragraphs, and the equivalent Schedules.

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

    Image Removed

    Status
    colourGreen
    titlePass

    Pass, created a long bill with lots of Parts inside Groups of Parts and a Schedule; plus some definitions

    7

    Press Ctrl+S or click on the Save button

    From v16.0 onwards, it is possible to cancel the Save action by clicking the ‘cancel' bar at the bottom of the window, provided the save process has not progressed too far

    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

    Got stuck on 99%, on closing and reopening I chose to open the auto-save version. Nothing was lost.

    (The progress bar does eventually disappear when it seems stuck on 99%, I was just impatient)

    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

    Image Removed

    Image Added

    Status
    colourGreen
    titlePass

    9

    Create cross reference(s) to sections that contain J-refs.

    Click Tag X-refs

    (v13) Use the Tools menu to display the J-refs in the cross-references (Tools > Show/hide J-refs in cross references)

    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

    should show in square brackets next to the X-ref

    Image Added

    Status
    colourGreen
    titlePass

    passed, also tried adding a new J ref and updating X-refs

    10

    Turn on Track Changes

    Using tracked changes

    Delete one or more elements / Insert element(s) and move element(s)

    Using tracked changes

    Inserted and deleted text and elements are display displayed in the editor and blue (insert) or red (deleted)

    Status
    colourGreen
    titlePass

    11

    Insert a Table of Contents

    Inserting table of contents

    Table is inserted at the start of the document

    Status
    colourGreen
    titlePass
    (with caveat)

    The title of the Groups of parts is not separated from the number by a space (not a problem because it looks fine in the PDF)

    12

    Generate PDF

    Generating and viewing a PDF

    Ensure:

    • Show ‘Show tracked changes changes’ is ticked

    • Select ‘Line numbering’

    • Select 'Side-lining'

    • Show Select ‘Show J-Refs in marginsmargins’

    • Show Select ‘Show J-Refs within cross referencesreferences’

    • Deselect Record Snapshot‘Record Snapshot’

    • Add a 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

    Line numbering is present and continues throughout the whole document

    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 the text entered.

    Image Removed

    Status
    colourGreen
    titlePass

    13

    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

    14

    Close the Editor

    Prompted to Save changes

    (If the option to save is selected) Changes are saved

    (If the option to discard changes is selects) Changes are not saved

    13

    ? Add Push/Pull tests

    ? Add Editor portion

    1415161718

    Final test - share with Scottish Parliament

    Status
    colourGreen
    titlePass

    15

    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

    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.

    New folder created with a duplicated version inside it

    Status
    colourGreen
    titlePass

    16

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

    Status
    colourGreen
    titlePass

    Pass, although I noticed that the selected section in the Structure View and the following one were both expanded

    17

    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

    18

    Renumber whole bill

    Renumbering provisions

    All the provisions are renumbered in the Editor

    The numbering in the structure view is sequential

    Status
    colourGreen
    titlePass

    19

    Delete all J-refs

    Managing J-refs

    No J-refs visible in the Editor
    No J-refs visible in the Structure View

    Status
    colourGreen
    titlePass

    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

    Pass, although I had a (non-reproducible) issue with selected sections not opening on my initial attempt. (Probably linked to my selections in the pop-up window)

    21

    Share with Scottish Parliament

    Using the menu next to a version of the Bill on the Project Tab, select Share version and choose the Scottish Parliament

    Sharing a document with another organisation

    Significant version of the Bill will appear on the project tab with the same name as the working version

    Status
    colourGreen
    titlePass

    22

    Login as an SP user and view shared significant version

    Duplicate the significant version to create a new working version

    The project should be accessible from the dashboard

    A significant version of the Bill will appear on the Project Tab with the same name as the original working version

    After duplicating, a working version of the Bill will appear on the project tab with the specified name under the specified folder heading

    Status
    colourGreen
    titlePass

    23

    Update document info for Bill (Stage 2):

    Open the ‘As Introduced’ version in the Editor

    Update the ‘Version rubric’ in the Document Information panel to make the Bill the ‘As Amended at Stage 2’ version

    Rubric text in the Editor is updated accordingly

    Status
    colourGreen
    titlePass

    24

    Share with PCO

    Sharing a document with another organisation

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

    Significant version will be visible to PCO users as well

    The significant version will not be visible to other users (e.g. HoC/HoL)

    Status
    colourGreen
    titlePass

    Pass - also confirmed the final AC here which is that HoC, HoL, SIH users etc. can’t see it

    25

    Login as an SP user and create Act version of Scottish Bill:

    Duplicate the working version and specify a version name and stage,
    Create an act version and to strip out page/line information

    Converting a Scottish Bill into an Act

    new working version created containing an act version of the Bill

    Status
    colourGreen
    titlePass

    26

    Update document info for SP Act:

    Update ‘Passed Date’ and ‘Assent Date’ in the Document Information pane in the Editor

    Preface of the Bill is updated accordingly

    Status
    colourGreen
    titlePass

    27

    Generate PDF official print

    PDF snapshot created and visible on the Project Tab

    Status
    colourGreen
    titlePass

    28

    Publish Official print (Submit to TNA)

    Submitting a Scottish Act to TNA

    A significant version of the Act will be created on the project tab
    The significant version will be visible to users in other organisations
    And a copy of the Act will appear on the PDR/API

    Status
    colourGreen
    titlePass

    Pass - visible to other SP users

    29

    Download zip file

    Downloading a ZIP file of a document

    A zip file is created containing XML, PDF and TIFF files

    Status
    colourGreen
    titlePass

    30

    31

    32