Versions Compared

Key

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

This page contains a series of introductory videos about using Lawmaker to draft SIs and SSIs.

Getting started - SI/SSIs in Lawmaker

Summary

  • Logging on to Lawmaker 

  • Viewing projects on the dashboard 

  • Opening a project and viewing all document versions

  • Opening and closing document in the Editor

Expand
titleScript of video 

This screencast covers: 

  1. Logging on to Lawmaker 

  2. Viewing projects on the dashboard 

  3. Opening a project and viewing all document versions 

  4. Opening and closing document in the Editor 

Logging on 

  1. To log on to Lawmaker, you will need your username and password.   

  2. The first time you log on, you will need to reset your password and set up Multi-factor Authentication (MFA).  To do this you will need to install an authenticator app on your mobile phone.   

  3. Once you have set yourself up to use Lawmaker, whenever you log on in future, you will only need to supply your username and password and a code from your authentication app 

  4. Contact your Lawmaker User Champion if you are struggling to log in. 

Dashboard 

  1. When you log into Lawmaker or when you click on the Home button, you will be taken to the dashboard.  This is where all the different projects that you have permission to view are displayed. 

  2. You can toggle between list view or tile view 

  3. You can search for a project by typing into the ‘Search’ input field.  You can search by any word that appears in the project title. The project title is based on the title of the documents in the project. 

  4. There is an option to view ‘Favourites’ which are projects you have ‘pinned’.  Projects that you create will have a pin in them by default so that they are always identified as a favourite.  You can add/remove pins on projects by clicking on the drawing pin on the project tile, or to the left of the project in list view and when you select to view ‘favourites’ these projects will always appear. 

  5. To open a project and view the document versions within it, click on the ‘Open’ button or on the project title. 

Projects tab 

  1. When you open a project, you will be taken to the ‘Projects’ tab and this is where all document versions that you have permission to view will be displayed 

  2. Documents can appear in different folders which can be expanded or collapsed as you please. 

  3. The green tiles on the left hand side are working document versions and can be edited. 

  4. The grey tiles on the right hand side are significant versions which are read only.   

  5. Significant versions are created whenever a document is shared with another organisation, you mark a document as submitted to the national archives,  and when you mark a document as having been signed. 

  6. Working versions might have some snapshot versions linked to them which you can view by toggling the triangle button on the left hand side.   

  7. These represent versions of the working version from a particular point in time and are either created automatically, for example when you generate a PDF; or 

  8. are manually created if you decide to save a snapshot when in the Editor.   

  9. Snapshots are read only when opened in the Editor, but it is possible to copy a provision within them to paste into your working document if you want to revert back to a previous version of a provision for example. 

  10. To open a document in the Editor, either to continue editing, or to view the document as a read-only document, click on the button to the left of the Actions’ drop down 

  11. If the document is editable (green tile), the button will be a pen and paper icon 

  12. If the document is read only (grey tile), the button will be a document icon 

Editor 

  1. The Editor will open in a new tab and load your selected document 

  2. I will come onto using the Editor in a separate screencast.   

  3. To ensure you close the document properly, always use the ‘Close document’ button that appears above this left hand structure view.  If the Structure view is collapsed, the button changes into a blue cross. 

Drafting SI/SSI provisions

Summary

  • Creating a new SI/SSI

  • Inserting provisions (including definitions and combined numbering)

  • Deleting provisions

  • Copy/cut & paste

  • Promote/demote

  • Wrap/Unwrap

  • Drag & drop

Expand
titleScript of video

This screencast includes: 

  1. Creating a new SI/SSI 

  2. Inserting provisions (including definitions and combined numbering) 

  3. Deleting provisions  

  4. Copy/cut & paste 

  5. Promote/demote 

  6. Wrap/Unwrap 

  7. Drag & drop  

Creating a new SI/SSI  

  1. To create a new SI/SSI project, click on the +New button at the top of your dashboard 

  2. Select the Type of document you want to produce and the Sub-type 

  3. Supply a title for your SI and the type of procedure it will be subject to.   

  4. Both of these can be updated later if anything changes 

  5. Click on ‘Create’ when ready 

  6. The Editor will open in a separate browser tab, containing the document template for the SI/SSI you have chose to create 

  7. This document will be available in read/write format to all other users in the same organisation as you 

  8. In my example, I selected a draft SI Regulations so I have the draft procedural rubric in the header of the document and ‘DRAFT’ appears in the banner. 

  9. The Editor is made up of  

  10. A Structure view on the left hand side which shows you the structure of your document as you build it up, which you can expand or collapse 

  11. The Editor view which is where you type and insert provisions 

  12. The right-hand panel which contains various tools which we will come to later 

  13. The upper tool bar which displays various menus containing editing functions which we will look at later, and finally 

  14. The breadcrumb which tells you the full context of an element where your cursor is placed.  

  15. Editing the preface will be handled in a separate screencast.  This screencast will focus on drafting the provisions in your SI/SSI 

Inserting provisions 

  1. To insert provisions into your document, place your cursor in the ‘body’ element and click ‘Enter’ to bring up the insert menu. 

  2. The insert menu will display all the elements you can insert into your document at this location.  

  3. I’m going to insert a regulation. 

  4. The cursor is ready for me to start typing into the heading element of the regulation 

  5. If you look at the Structure View, you will see the inserted regulation 

  6. If you look at the breadcrumb, you will see the full context of the element my cursor is in 

  7. To continue adding content to the regulation I can tab or click with my mouse button to move the cursor into the ‘text’ element ready for me to start typing. 

  8. I can continue to add further provisions into my SI/SSI, by clicking ‘Enter’ and selecting the next appropriate element.   

  9. Here I will insert a paragraph.   

  10. I can continue by adding sub-paragraphs. 

  11. To insert a paragraph with combined numbering, I must insert another paragraph into my empty paragraph which will automatically combine the numbering for me. 

  12. I can insert definitions which contain an inline element placeholder for the defined term.  To add text before or after the defined term, I will use the arrow keys to move my cursor into the correct location before typing.   

Deleting provisions 

  1. The key to successfully deleting provisions is to use the breadcrumb or the structure view to select the provision before deleting.   

  2. To delete this regulation, I can either click on ‘regulation’ in the breadcrumb 

  3. Or click on the regulation in the structure view  

  4. The provision will be highlighted in the Editor so that you can make sure you have selected the correct provision 

  5. Use the ‘delete’ key or backspace to delete the selected provision.  

Copy/cut & paste 

  1. The breadcrumb and structure view also comes in handy when you need to copy or cut a provision and paste it into the same document or another one.   

  2. First select the provision you want to copy or cut using the breadcrumb or structure view 

  3. Then use right-click and select ‘copy element’ or ‘cut provision’ or use the universal keyboard short cut Ctrl + C or Ctrl + X.   

  4. Finally, place your cursor at the location you want to paste the provision and use the keyboard shortcut ctrl + v. 

Promote/demote 

  1. Sometimes it might be necessary to convert a sub-paragraph into a paragraph or vice versa and we call this promote and demote. 

  2. First I will demonstrate ‘promote’ 

  3. Place your cursor in the provision you want to promote, and right-click and select ‘promote element’ 

  4. In this example the provision is promoted first to being closing words for the list of paragraphs, and when I promoted it again, it became a paragraph higher up 

  5. Now I will demonstrate a ‘demote’ using the same provision 

  6. As my cursor is already in the provision I want to promote, I will right-click and this time select ‘demote element’ 

Wrap/unwrap 

  1. As the SI/SSI begins to build up, you might decide some grouping elements are required. 

  2. Grouping elements are things like parts, chapters, sections and sub-sections.   

  3. We use the term ‘wrap’ when inserting them as in XML terms they are wrapping around the provisions that they contain.  

  4. With that in mind, the first step will be to highlight the provisions you want to wrap in a grouping element.   

  5. The best way to select multiple sibling provisions is to use Ctrl + left click on the mouse in the Structure View to select more than one provision at a time.   

  6. Here I have selected 3 regulations that I want to wrap inside a Part. 

  7. In the Editor, right-click on the selected provisions and select “wrap element”.   

  8. Here are the grouping levels that you can use.  I will select “Part” 

  9. The part is inserted and displayed in the Editor here. 

  10. I can see that it has been successfully inserted as the structure view shows the regulations are now inside the part 

  11. And the breadcrumb shows part in the hierarchy. 

  12. You can continue adding grouping levels inside Parts using the same method, for example to further wrap the provisions inside Chapters or Sections or Sub-sections. 

  13. Conversely, if you have a grouping element that you no longer need, you need to remove them by ‘unwrapping’ them.  

  14. To unwrap a grouping element, place your cursor in the selected grouping element in the Editor and right-click and select “Unwrap element”.   

  15. This will remove the grouping element the correct way from your document.   A common mistake when users first use Lawmaker is to delete the grouping element.  This will not correctly remove the element and will be highlighted as a validation error in the right-hand panel.  More on that in another screencast. 

  16. You can insert and remove grouping elements inside schedules in exactly the same way. 

Moving provisions around using the Structure view 

  1. It’s possible to move provisions around the document using the Structure View 

  2. You can move whole grouping levels, individual regulations or individual lower-level paragraphs.   

  3. First select the provision you wish to move.  If it has child elements you need to make sure the provision is collapsed in the structure view before you use drag & drop.   

  4. Next press and hold the left mouse button and then move it to the desired location.   

  5. The green provisions indicate where you are allowed to move the provision to.   

Managing footnotes, textual amendments and references in your SI/SSI

https://protect-euwww.mimecastyoutube.com/s/PhSlCzvMGfjEJmjTK3OzFwatch?domain=youtu.bev=SHW-GSOaulg

Summary

  • Inserting and managing footnotes

  • Inserting textual amendments (quoted structures)

  • Inserting and managing cross references

  • Inserting and managing J-refs

Expand
titleScript of video

[to be added]

Numbering, renumbering and num locks

https://protect-euwww.mimecastyoutube.com/s/EICUCAN35CDB71DSQYk1cwatch?domainv=youtu.be1EnqGp16pwM

Summary

  • Numbering modes

  • Renumbering provisions and locked nums

Expand
titleScript of video

[to be added]

Managing SI/SSIs in Lawmaker 

https://protect-euwww.mimecastyoutube.com/s/bnh5CBN35CL0ElLs11y_W?domain=youtu.bewatch?v=zVkK_scrt8Q

Summary

  • Project tab 

Expand
titleScript of video

[to be added]

Managing your SI/SSI through the different stages

https://protect-euwww.mimecastyoutube.com/s/PgnNCD135C8wgO8tRwPlzwatch?domainv=youtu.be1Rq9aH6how8

Summary

  • Converting a draft instrument to ‘Made’

  • Preparing an instrument for signing

  • Marking PDF version as having been signed

  • Downloading a ZIP file to upload to TNA’s publishing system

  • Marking downloaded version as having been submitted to TNA

Expand
titleScript of video

[to be added]

Updating the preface, explanatory note and signature blocks in SI/SSIs

https://protect-euwww.mimecastyoutube.com/s/ywnuCE835CZOR6ZSxJAbdwatch?domainv=youtu.be0iBLRKggfU4

Summary

  • Updating the preface

  • Inserting and updating an explanatory note

  • Inserting a signature block

  • Inserting and updating a commencement history table

  • Inserting a table of contents

Expand
titleScript of video

[to be added]

Managing tables and images

https://protect-euwww.mimecastyoutube.com/s/YuQ1CGv3jfzEjLztrwLCdwatch?domainv=youtu.be0ni63oyZ768

Expand
titleScript of video

[to be added]

Generating a PDF of your SI/SSI

https://protect-euwww.mimecastyoutube.com/s/jnfuCJy3mcjl0QjTKpvUgwatch?domain=youtu.bev=M2lf4x-hFfw

Summary

  • Generate PDF from Project Tab or Editor

  • Generate sub-set of provisions

  • Footers, J-Refs and snapshots

Expand
titleScript of video

[to be added]

Checking your document is valid

https://protect-euwww.mimecastyoutube.com/s/B7-5CK13nCRP3rRUkOdLH?domain=youtu.bewatch?v=6JQbZMaUYYY

Summary

  • Tracked changes and comments

  • Document checks

  • Attributes

Expand
titleScript of video

[to be added]

Introduction to XML (slide deck)

See Introduction to XML.