This module will explain how to insert, modify and delete provisions in your document, with some exercises to allow you to practice this and find out about some useful shortcuts built into the Editor to help make drafting easier.
...
https://lawmaker.atlassian.net/wiki/x/gIIK
📚 Exercises
✏️ Insert basic provisions
| Panel |
|---|
| panelIconId | atlassian-light_bulb_on |
|---|
| panelIcon | :light_bulb_on: |
|---|
| panelIconText | :light_bulb_on: |
|---|
| bgColor | #EAE6FF |
|---|
|
Key learning points Placeholders are the grey highlighted elements e.g. “Heading” or “Text” that you type into. Em-dashes can be inserted by the keyboard shortcut of typing dash twice “--” which will auto-convert them into an em-dash “—”
|
Starting point
...
🛠️ Getting Started
Before you can draft a bill, you will need to create your own training project containing a half finished bill to continue drafting.
For these exercises, create a project containing a half finished bill:
The following steps will allow you to create the data required for this exercise..| Expand |
|---|
| title | How to create a new project |
|---|
|
Download the XML document for the exercise by clicking on the link you’ve been provided with. By default, the downloaded file is usually placed in the “downloads” folder on your computer. Log in to Lawmaker. From the Dashboard, create a new project of the type you need for the exercise. Give it a title such as [Your Initials] Drafting a bill. (See Creating a new project.) From the Project tab for that project, select Document Actions > Upload document, and select the XML file for the exercise which you have downloaded. It can be uploaded into the default folder that has been created in the project. (See Create a new document by uploading an XML file.) On the newly uploaded document version, select Actions > Update Document Information and update the Title to match the title you originally gave the project. Open the imported document in the Editor
|
✏️ Exercise 1: Insert basic provisions
This exercise takes you through the process of inserting provisions
Start by recreating the following section after section 6:
...
Step 1: Insert a section and definitions
Insert a new section after section 5 containing some definitions.
| Expand |
|---|
| title | Detailed steps on creating the section and definitions |
|---|
|
Place your cursor in the empty body placeholder element Click Enter on your keyboard to view the insert menu Click Enter again to insert the default element at the top of the insert
|
...
menu (for Bills, this will be a Section
|
...
). Type Interpretation into the Heading placeholder Use tab on your keyboard or click using the mouse to move the cursor into the ‘Text’ placeholder for the subsection and type In this Act— To insert the definitions, click Enter and use the arrow keys on your keyboard or click using the mouse to select Definition from the insert menu, clicking Enter to insert
|
...
A definition will be inserted, made up of 2 placeholders—
...
...
. Type “the Department” means the Department for Communities; into the first definition Insert the second definition by clicking Enter again
|
...
To type the before the defined term, you will need to click on the left arrow on your keyboard once to move your cursor into the ‘Text’ element so that the breadcrumb reads Bill > body > Part > Section > Subsection > Definition > Content > Text Move your cursor back into the defined term and type “emergency period” and move your cursor into the empty ‘text’ placeholder element and type has the meaning given by section 1(2).
|
...
Expected outcome
...
Video recording
[Insert link to video recording completing this exercise]
...
Step 2: Convert the subsection into section content
Promote the subsection into section content when a section is not divided into subsections.
| Expand |
|---|
| title | Detailed steps to promote a provision |
|---|
|
Place your cursor in the remaining subsection Promote it to become section content using any of the following options— Right-click and select Promote element, Select Tools > Promote element, Keyboard shortcut ALT+[
Place your cursor anywhere in the last definition and click Enter to view the insert menu Use the down arrow key on your keyboard or click using the mouse to select Subsection from the insert menu, clicking Enter to insert it— A subsection is inserted after your cursor location (after the last definition) The section content will auto-convert to subsection (1)
Type in the content of the second subsection.
|
Step 3: Renumber the section and those around it
Renumber the whole document (See Renumbering provisions )
...
| Panel |
|---|
| panelIconId | atlassian-light_bulb_on |
|---|
| panelIcon | :light_bulb_on: |
|---|
| panelIconText | :light_bulb_on: |
|---|
| bgColor | #EAE6FF |
|---|
|
Key learning points Where provisions are inserted: Lawmaker will insert your chosen provision in the next valid position after your cursor location. This is useful to know when you want to add a provision at the start of a series of provisions. Breadcrumb isat the The breadcrumb isat the bottom of the Editor view and shows you exactly where you cursor is placed in the Editor. If you have your cursor in the heading of the section for example, the breadcrumb will read— Bill > body > Section > Heading
|
Starting point
...
Instructions
Place your cursor in the section num “1.”
The breadcrumb will read Bill > body > Section > Num
Use your right arrow key to move your cursor until the breadcrumb changes to Bill > body > Section
Click Enter to view the insert menu
Select Subsection (1) and click Enter again to insert
The subsection will be inserted before your existing subsection
Expected outcome
...
Video recording
[Insert link to video recording completing this exercise]
✏️
...
Starting point
...
Instructions
Remove the newly inserted subsection by placing your cursor in the empty Text placeholder
The breadcrumb should say Bill > body > Section > Subsection > Content > Text
Use your mouse to select Subsection from the breadcrumb
The whole subsection (num and text) will be highlighted
Delete it using backspace or Delete on your keyboard or right-click with your cursor on the Subsection breadcrumb and select Delete Element
The subsection will be safely deleted
To undo this deletion, select the Undo button
Image Removedin the upper tool bar or use the keyboard short cut CTRL + Z
To redo the deletion, select the Redo button 
Image Removed in the upper tool bar or use the keyboard short cut CTRL + Y
Expected outcome
...
Exercise 2: Divide a provision
In section 2, split subsection (3) so that it is divided into 2 child paragraphs—
...
Step 1: Split Subsection (3)
Split the introducing words in Subsection (3) into separate provisions
| Expand |
|---|
| title | Detailed steps to split a provision into multiple provisions |
|---|
|
In section 2(3), place your cursor after the word ‘may’ Type ‘--’ to insert an em-dash Split the provision by right-clicking and selecting Split Element or use keyboard short-cut ALT+S. Delete the space before your second subsection text Repeat by placing your cursor after the word ’and' in the newly created subsection, splitting the element and tidying any spaces again
|
Step 2: Demote the subsections
Demote the sibling subsections created from the split into paragraphs
| Expand |
|---|
| title | Detailed steps to demote a provision |
|---|
|
Place your cursor in subsection (4) (the first of the sibling subsections created from splitting the element) Demote the subsection so that it becomes a paragraph by right-clicking and selecting Demote Element, using Tools > Demote Element in the upper toolbar or using keyboard short ALT+] Repeat for the second subsection created from splitting the element so that you end up with 2 child paragraphs of subsection (3)
|
Video recording
[Insert link to video recording completing this exercise]
✏️
...
| Panel |
|---|
| panelIconId | atlassian-light_bulb_on |
|---|
| panelIcon | :light_bulb_on: |
|---|
| panelIconText | :light_bulb_on: |
|---|
| bgColor | #EAE6FF |
|---|
|
Key learning points Converting subsection into section content using the promote feature. Auto-converting section content into a subsection when a second subsection is inserted. |
Starting point
...
Instructions
Place your cursor in the remaining subsection
Promote it to become section content using any of the following options—
Right-click and select Promote element,
Select Tools > Promote element,
Keyboard shortcut ALT+[
The subsection will turn into an unnumbered section content element.
Place your cursor anywhere in the last definition and click Enter to view the insert menu
Use the down arrow key on your keyboard or click using the mouse to select Subsection from the insert menu, clicking Enter to insert it—
A subsection is inserted after your cursor location (after the last definition)
The section content will auto-convert to subsection (1)
Type in the content of the second subsection.
Expected outcome
...
Video recording
[Insert link to video recording completing this exercise]
✏️ Promoting/demoting provisions
Starting point
Instructions
Expected outcome
Video recording
[Insert link to video recording completing this exercise]
✏️ Converting section content to a subsection
Starting point
Instructions
Expected outcome
Video recording
[Insert link to video recording completing this exercise]
✏️ Grouping levels and wrapping/unwrapping provisions
Starting point
Instructions
Expected outcome
Video recording
[Insert link to video recording completing this exercise]
✏️ Converting a section to a schedule and vice versa
Starting point
Instructions
...
Exercise 3: Merge provisions
In section 2(3), remerge the paragraphs so that they are a single subsection again
...
Step 1: Merge the paragraphs
Merge paragraph (a) and paragraph (b) into a single paragraph
| Expand |
|---|
| title | Detailed steps to merge provisions |
|---|
|
Highlight both provisions in the Editor, or use multi-select in the Structure view to select both paragraphs (see https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/9339303/Using+the+structure+view#Selecting-more-than-one-provision Merge the 2 paragraphs by right-clicking and selecting Merge Elements
|
Step 2: Promote the paragraph
Promote paragraph (a) into a subsection.
| Expand |
|---|
| title | Detailed steps to promote a provision |
|---|
|
Place your cursor in paragraph (a) (containing the merged paragraphs) Promote the paragraph so that it becomes a subsection by right-clicking and selecting Promote Element, using Tools > Promote Element in the upper toolbar or using keyboard short ALT+[
|
Step 3: Merge the subsections
Merge the 2 subsections into a single subsection (see https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/9339235/Splitting+and+merging+provisions#How-to-merge-provisions )
✏️ Exercise 4: Inserting and removing grouping levels (wrapping/unwrapping)
Restructure the whole document by dividing it into 3 parts and removing all cross headings.
...
Step 1: Remove the cross headings
Remove the 2 x cross headings inside part 1 by unwrapping them.
| Expand |
|---|
| title | Detailed steps to unwrap grouping levels |
|---|
|
Place your cursor in the first cross heading To remove the cross heading, right-click and select Unwrap Element or select Tools > Unwrap Element. The sections in the removed cross headings will automatically move into the remaining cross heading so as to maintain valid structure. Repeat with the second cross heading to remove the remaining cross heading
|
Step 2: Insert a new part
Insert a new part after the first part, renaming the first part to Meetings and calling the second part Performance
| Expand |
|---|
| title | Detailed steps to insert a grouping level |
|---|
|
Place your cursor anywhere inside part 1 Click Enter to view the insert menu Select Part Type into the Part heading Performance Go back to the first part and updating the heading to just Meetings
|
Step 3: Move sections
Move sections 3, 4 and 5 into the newly created part called performance
| Expand |
|---|
| title | Detailed steps to move provisions using the structure view |
|---|
|
Either— Multi-select sections 3 to 5 in the structure view (see https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/9339303/Using+the+structure+view#Selecting-more-than-one-provision ) Cut them using Edit > Cut, right-click and selecting Cut or using keyboard shortcut CTRL+X Place your cursor in the newly inserted part Paste the cut sections using keyboard short cut CTRL+V
Or Drag the sections one-by-one into the newly inserted part using the structure view See https://lawmaker.atlassian.net/wiki/spaces/USERMANUAL/pages/9339163/Moving+provisions+tables+and+amendments+within+a+document#Moving-using-the-structure-view
|
Step 4: Renumber the whole document
Renumber the whole document (See Renumbering provisions )
✏️ Exercise 5: Converting a section to a schedule
Convert section 4 into a schedule and then undo the changes
...
Step 1: convert section into schedule
Convert section 4 into a schedule.
| Expand |
|---|
| title | Detailed steps to convert a section into a schedule |
|---|
|
Place your cursor in section 4 Right-click and select Convert to/from Schedule… Update the schedule heading with Performance Rename the schedule cross heading by deleting 'Performance' from the start and capitalising the first word Type into the reference note ‘Text’ element the section/provision that calls the schedule e.g. Section 2
|
Step 2: Undo
Undo the conversion of section 4 into a schedule
| Expand |
|---|
| title | Detailed steps to undo changes |
|---|
|
Undo your most recent changes by clicking on the Undo button in the upper toolbar Image Added, selecting Edit > Undo or using keyboard short cut CTRL + Z Repeat the undo action until all your recent changes have been rolled back and section 4 reappears in the document.
|
Video recording
[Insert link to video recording completing this exercise]
