📘 Introduction
📚 Exercises
🛠️ Getting Started
Before you can create inline amendments, you will need a published version of the bill (download the XML file here
The following steps will allow you to create the data required for this exercise.
Create a new project selecting Northern Ireland Bill and Executive Bill and providing the title [Your Initials] Inline Amending Bill
Close the Editor after it loads using the Close Editor button.
From the Project tab, select Document Actions > Upload document—
Specify a folder As Introduced
Specify a version description As Introduced
Select the downloaded Inline_amending_bill.xml file
Click on Upload button
Find the newly uploaded document version and select Actions > Update Document Information—
Update the Title to [Your Initials] Inline Amending Bill
Click on Update button
Find the imported document on the Project tab and select Actions > Generate PDF
Click on the black triangle to the left of the imported bill version name to expand the view of snapshots
On the grey PDF snapshot version, select Actions > Publish version
The published version will appear on the right-hand side of the Project tab and a snapshot is created under the working version.
You now have a published version of a bill reading to start creating amendments inline.
✏️ Creating textual amendments (leave out, insert and substitute)
On the Amendment Workspace tab, click on the +New button
In the Create new list of draft amendments dialog box—
Type of amendment - select Inline
Bill version can be left as As Introduced
Select Consideration Stage for Stage
Add a unique list name e.g. Textual amendments
Click on the Create button
The inline document will open in the Editor in a new browser tab
Insert text amendments
Create a simple ‘insert' amendment by—
In Section 2, within Article 44A—(1) (in the inserted text), place your cursor after 'hotel' and click Enter to view the insert menu
Select Insert text—
an empty text element which is surrounded by blue square brackets ready to start typing into
a new card appears in the right-hand panel with the text Insert indicating it is an insert-type amendment
Within the text element, type ‘a country mansion,’
Save your changes—
a unique ID (Dnumber) is assigned which appears on the card in the Inline Amendments right-hand panel and next to the amendment inline.
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button—
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab
The amendment you just created is displayed
Close the traditional list of draft amendments using the Close Editor button
Now recreate the following 3 insert text amendments in your inline document
Save your changes and click on the View Traditional Amendments button on the Inline Amendment Tools panel (if you still had the traditional amendments open in a separate tab, you will need to refresh the list to see the changes by clicking on the refresh button in your browser)
Expected output with brief explanation of the type of amendment created
Type of amendment | Traditional amendment |
---|---|
Example of an amendment with ordinality | |
Example of inserting text at the start of a provision | |
Example of inserting text immediately before punctuation (before the ending full-stop) |
Close the traditional list of draft amendments using the Close Editor button
Leave out text amendments
Create a simple ‘leave out' amendment by—
In Clause 3, within Article 44C—(1) (in the inserted text), highlight the text 'in relation' and in the hovering tool bar, click on Leave Out
Save your changes
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab with your first amendment displayed
Close the traditional list of draft amendments using the Close Editor button
Now recreate the following 2 leave out text amendments in your inline document
Save your changes and click on the View Traditional Amendments button on the Inline Amendment Tools panel (if you still had the traditional amendments open in a separate tab, you will need to refresh the list to see the changes by clicking on the refresh button in your browser)
Expected output with brief explanation of the type of amendment created
Type of amendment | Traditional amendment |
---|---|
Example of an amendment with ordinality | |
Example of leaving out text that spans over a line |
Close the traditional list of draft amendments using the Close Editor button
Substitute text amendments
Create a simple ‘substitute' amendment by—
In Section 4(1)(b), highlight the text '“first”' and in the hovering tool bar, click on Substitute—
an empty text element appears
the text that was highlighted is coloured red and struck out
square brackets surround all these changes
a new card appears in the right-hand panel with the text Substitute indicating it is an substitute-type amendment
Within the text element, type ‘“second”’
Save your changes
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button—
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab with your first amendment displayed
Close the traditional list of draft amendments using the Close Editor button
Now recreate the following 3 substitute text amendments in your inline document
Save your changes and click on the View Traditional Amendments button on the Inline Amendment Tools panel (if you still had the traditional amendments open in a separate tab, you will need to refresh the list to see the changes by clicking on the refresh button in your browser)
Expected output with brief explanation of the type of amendment created
Type of amendment | Traditional amendment |
---|---|
Substitute a phrase | |
Substitute a single word | |
Leaving out words that span over a line to the end of a line |
Close the traditional list of draft amendments using the Close Editor button
Close the inline document as well using the Close Editor button
✏️ Creating structural amendments (leave out, insert and substitute)
On the Amendment Workspace tab, click on the +New button
In the Create new list of draft amendments dialog box—
Type of amendment - select Inline
Bill version can be left as As Introduced
Select Consideration Stage for Stage
Add a unique list name e.g. Structural amendments
Click on the Create button
The inline document will open in the Editor in a new browser tab
Set your renumbering mode to “Off” by selecting Tools > Turn on/off renumbering until the green success message says Auto Renumbering: OFF
Insert structure amendments
Create a simple ‘insert' amendment by—
In Section 5, place your cursor anywhere in subsection (1) and click Enter to view the insert menu
Select Subsection—
a subsection is inserted containing an empty text element which is surrounded by blue square brackets ready to start typing into
a new card appears in the right-hand panel with the text Insert indicating it is an insert-type amendment
Within the text element, type ‘Regulations may modify paragraph (2) so as to add or remove a reference to licensed premises of a specified kind.’
Save your changes—
a unique ID (Dnumber) is assigned which appears on the card in the Inline Amendments right-hand panel and next to the amendment inline.
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button—
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab
The amendment you just created is displayed
Close the traditional list of draft amendments using the Close Editor button
Now recreate the following 4 insert structure amendments in your inline document
Inserting a new section before section 8
Inserting a new section after section 8
Inserting a new section after section 9 that is contained within a cross heading
Inserting a new subsection with child paragraphs in section 7
Save your changes and click on the View Traditional Amendments button on the Inline Amendment Tools panel (if you still had the traditional amendments open in a separate tab, you will need to refresh the list to see the changes by clicking on the refresh button in your browser)
Expected output with brief explanation of the type of amendment created
Type of amendment | Traditional amendment |
---|---|
Insert new clause before | |
Insert new clause after | |
Insert new clause with grouping level (cross heading in this instance) | |
Insert new subsection with child paragraphs |
Close the traditional list of draft amendments using the Close Editor button
Leave out structure amendments
Create a simple ‘leave out' structural amendment by—
In Clause 10, place your cursor in subsection (2)(b) and select ‘Paragraph’ from the breadcrumb to highlight the whole paragraph
There isn’t a hovering tool bar when you select whole provisions, so instead view Inline Amendment Tools in the right-hand panel and click on Leave Out
the paragraph you highlighted will be coloured red and appear struck out
a new card will appear in the Inline Amendments right-hand panel with the text ‘Leave out’
Save your changes
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab with your new amendment displayed
Close the traditional list of draft amendments using the Close Editor button
Now recreate the following 3 leave out structure amendments in your inline document
Leave out subsection (3)(b) which will include the child quoted structure
Leave out Subsection (5) which will include the children paragraphs
Leave out section 11
Save your changes and click on the View Traditional Amendments button on the Inline Amendment Tools panel (if you still had the traditional amendments open in a separate tab, you will need to refresh the list to see the changes by clicking on the refresh button in your browser)
Expected output with brief explanation of the type of amendment created
Type of amendment | Traditional amendment |
---|---|
Leave out subsection (3)(b) which will include the child quoted structure | |
Leave out Subsection (5) which will include the children paragraphs | |
Leave out section 11 which, as you’ve selected Consideration Stage when creating the inline document, will auto-convert the wording to the ‘stand part’ motion wording which you will need to manually updating in the traditional list as appropriate |
Close the traditional list of draft amendments using the Close Editor button
Substitute structural amendments
Create a simple ‘substitute' structural amendment by—
In Section 13, place your cursor in subsection (1) and select ‘Subsection’ from the breadcrumb to highlight the whole provision
There isn’t a hovering tool bar when you select whole provisions, so instead view Inline Amendment Tools in the right-hand panel and click on Substitute
the subsection you highlighted will be coloured red and appear struck out
a new subsection will be inserted after in blue text
a new card will appear in the Inline Amendments right-hand panel with the text ‘Substitute’
Type into the empty ‘text’ element ‘In Article 60 of the Licensing Order (sale, etc., of intoxicating liquor to young persons), after paragraph (4) insert “The”’
Save your changes
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab
your new substitute amendment is displayed
Close the traditional list of draft amendments using the Close Editor button
Now recreate the following 1 substitute structure amendment in your inline document
Save your changes and click on the View Traditional Amendments button on the Inline Amendment Tools panel (if you still had the traditional amendments open in a separate tab, you will need to refresh the list to see the changes by clicking on the refresh button in your browser)
Expected output with brief explanation of the type of amendment created
Type of amendment | Traditional amendment |
---|---|
Substitute subsection (3) including the child paragraphs and their child quoted structures |
Close the traditional list of draft amendments using the Close Editor button
Close the inline document using the Close Editor button
✏️ Creating hybrid amendments (part textual and part structural in composition)
On the Amendment Workspace tab, click on the +New button
In the Create new list of draft amendments dialog box—
Type of amendment - select Inline
Bill version can be left as As Introduced
Select Consideration Stage for Stage
Add a unique list name e.g. Hybrid amendments
Click on the Create button
The inline document will open in the Editor in a new browser tab
Set your renumbering mode to “Off” if you haven’t already by selecting Tools > Turn on/off renumbering until the green success message says Auto Renumbering: OFF
Insert hybrid amendments
Create an advanced ‘insert' hybrid amendment to understand the mechanics behind it by—
In Section 23, place your cursor immediately after the text ‘paragraph (3)’ and click Enter to view the insert menu
Select Insert text—
an empty ‘text’ placeholder appears surrounded by blue square brackets ready to start typing into
a new card appears in the right-hand panel with the text Insert indicating it is an insert-type amendment
Within the text element, type ‘—’
Click Enter to view the insert menu
Select Paragraph (a)
Type ‘in sub-paragraph (a), omit “Good Friday or”, and’
Click Enter to view the insert menu and select Paragraph (a) again
Leave the empty ‘text’ placeholder empty as Lawmaker will insert the moved trailing text into this second paragraph when the amendment is applied
Save your changes—
a unique ID (Dnumber) is assigned which appears on the card in the Inline Amendments right-hand panel and next to the amendment inline.
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button—
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab
The amendment you just created is displayed (remember: empty placeholders do not render on the PDF so you can leave the empty ‘text’ element where it is).
Close the traditional list of draft amendments using the Close Editor button
Now recreate the following 3 insert hybrid amendments in your inline document
Save your changes and click on the View Traditional Amendments button on the Inline Amendment Tools panel (if you still had the traditional amendments open in a separate tab, you will need to refresh the list to see the changes by clicking on the refresh button in your browser)
Expected output with brief explanation of the type of amendment created
Type of amendment | Traditional amendment |
---|---|
Breaking subsection (2)(a) into 2 paragraphs | |
Adding 2 paragraphs to the end of subsection (3) Note that the text is added after the full-stop so that Lawmaker knows it should use the ‘at end’ form of words. |
Close the traditional list of draft amendments using the Close Editor button
Leave out hybrid amendments
Create a simple ‘leave out' hybrid amendment by—
In section 25, within Article 26A(1) (in the inserted text), highlight the word ‘which’ and include paragraphs (a) to (b) with the highlight
In the hovering tool bar select Leave Out
the text and paragraphs you highlighted will be coloured red and appear struck out
a new card will appear in the Inline Amendments right-hand panel with the text ‘Leave out’
Save your changes
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab with your new amendment displayed (note that because the provisions being left out were inside a quoted structure, Lawmaker automatically refers to them as ‘lines’ rather than paragraphs)
Close the traditional list of draft amendments using the Close Editor button
Now recreate the following leave out hybrid amendment in your inline document
Save your changes and click on the View Traditional Amendments button on the Inline Amendment Tools panel (if you still had the traditional amendments open in a separate tab, you will need to refresh the list to see the changes by clicking on the refresh button in your browser)
Expected output with brief explanation of the type of amendment created
Type of amendment | Traditional amendment |
---|---|
Hybrid leave out which will merge 2 separate subsections into a single subsection |
Close the traditional list of draft amendments using the Close Editor button
Substitute hybrid amendments
Create a simple ‘substitute' structural amendment by—
In Section 26(5) highlight from ‘paragraph' until ‘in’ in section 26(5)(c)
In the hovering tool bar click on Substitute
all the text and paragraphs you highlighted will be coloured red and appear struck out
a new ‘text’ element will be inserted after the red text
a new card will appear in the Inline Amendments right-hand panel with the text ‘Substitute’
Type into the empty ‘text’ element ‘sub-paragraph (a) and’
Save your changes
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab
your new substitute amendment is displayed
Close the traditional list of draft amendments using the Close Editor button
Close the inline document using the Close Editor button
✏️ Creating amendments involving cross references
On the Amendment Workspace tab, click on the +New button
In the Create new list of draft amendments dialog box—
Type of amendment - select Inline
Bill version can be left as As Introduced
Select Consideration Stage for Stage
Add a unique list name e.g. cross references in amendments
Click on the Create button
The inline document will open in the Editor in a new browser tab
Set your renumbering mode to “Off” if you haven’t already by selecting Tools > Turn on/off renumbering until the green success message says Auto Renumbering: OFF
Amending text of a cross reference
Amend Section 36(1)(b) by changing the cross reference ‘section 33’ to ‘section 34’—
Highlight the '3’ within section 33
The hovering tool bar will not appear as you are modifying a cross reference and instead it presents the cross reference hovering tool bar
Circumvent this by opening the Inline Amendment Tools and selecting Substitute
Lawmaker will not let you change part of a cross reference so it automatically highlights the whole cross reference to strike out so you will need to recreate the whole cross reference by typing Section 34 into the empty ‘text’ placeholder
Save your changes
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab
your new amendment is displayed
Close the traditional list of draft amendments using the Close Editor button
Inserting marked up cross references into your document
As your inline document is a copy of the bill that is being amended, you can create cross references to the provisions within it and these will be inserted as valid cross references into the ‘as amended’ bill version if this amendment is applied.
In the Structure View of the inline document, right-click on section 34 and select Select reference to copy > section 34
In section 36(1)(b), delete section 34 text using backspace
Check the breadcrumb to ensure that your cursor is in ‘Insert text’ and use keyboard shortcut CTRL+V to paste the cross reference you just copied from the structure view—
the text Section 34 will appear
it will be coloured purple to indicate that it is a valid internal cross reference
Save your changes
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab
your new amendment is displayed
Close the traditional list of draft amendments using the Close Editor button
Amending a cross reference which covers a range of provisions
Amend Section 36(1)(c) by attempting to change the cross reference to subsection (2) to (3)—
Highlight the '2’ within subsection (2)
The hovering tool bar will not appear as you are modifying a cross reference and instead it presents the cross reference hovering tool bar
Circumvent this by opening the Inline Amendment Tools and selecting Substitute
Lawmaker will not let you change part of a cross reference so it automatically highlights the whole cross reference to strike out. In this case, the cross reference covers the range (2) to (6) so you will need to type in the full cross reference section 34(3) to (6)
Save your changes
Open the Inline Amendment Tools in the right-hand panel
Click on the View Traditional Amendments button
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab
your new amendment is displayed
Close the traditional list of draft amendments using the Close Editor button
✏️ Adding proposers and supporters
From the Amendment Manager, select the inline document called cross references in amendments and open it in the Editor
In the Editor, view the Inline Amendment Tools right-hand panel
Click on the Manage Members button and in the Manage proposers and supporters dialog box—
Add a proposer name (select between a Member’s chair title, ministerial title or just their name depending on the capacity in which they are laying the amendment)
Optionally add one or more supporter’s names
Click on the Update button
Save your changes
Click on the View Traditional Amendments button
A document showing a list of draft traditionally formatted amendments will open in the Editor in a new browser tab
your new amendment is displayed with the assigned proposer and any supporters
Click on the proposer for any amendment in your traditional list of draft amendments and the Manage proposers and supporters dialog box will open—
Change the proposer name, and
Add one or more supporters to your amendment
Click on Update button
Save your changes and see how that amendment is the only amendment that is updated with the new Member information.
To update proposers and/or supporters in more than one amendment at the same time select Tools > Update Members… from the upper toolbar—
Select a subset of amendments to update (defaults to All)
Select Replace proposer with the selected member
Type a proposer’s name into the Member(s) input field
Click on the Update button
Have a play with the other bulk options and save your changes when you’ve finished updating your list of draft amendments.
Close the traditional amendment list by selecting the Close Editor button
Using Manage Members in the inline document will assign the same proposer (and any supporters) to ALL amendments in the document.
You can more finely tune which amendments will be assigned which proposer in the traditional list view.
Tips
Create a new inline document per proposer which will make it easier to manage proposers on all the amendments in your document
If you need to manage different supporters or proposers within the same document, make these changes in the traditional document by updating the individual amendment in the Editor, or making updates in bulk using Tools > Update Members… in the upper toolbar
✏️ Making tweaks to the traditional amendment
From the Amendment Manager, select the inline document called Structural amendments and open it in the Editor
In the Inline Amendment Tools right-hand panel, click on the View Traditional Amendments button
In the traditional list, find a new clause amendment and add NEW TEXT to the section heading in the quoted structure.
Save your changes, make a note of its DNumber and close the traditional list using the Close Editor button.
In the inline document, view the Inline Amendments right-hand panel and find the amendment that you just updated using the DNumber that you noted down in the step before and see a black warning triangle appears next to the amendment
Click on the amendment card to jump to the inline amendment in your inline document and note that the inline amendment doesn’t show NEW TEXT in the heading because traditional amendments do not backwards synchronise with their inline equivalents.
Attempt to add some text to the amendment and you will see a yellow warning message appear letting you know that it’s not possible to make changes due to the out-of-sync warning marker
In the Inline Amendment right-hand panel, click on the black warning triangle and a Remove out-of-sync warning marker dialog box appears—
This warning lets you know that the traditional version of this amendment has been updated,
If you make a change to the inline version of the amendment, it would overwrite your traditional version so the warning prevents you making any changes and unwittingly overwriting your traditional version
Click on the Remove button
Add DIFFERENT TEXT to the header of the same new clause amendment. This time you will be able to.
Save your changes
In the Inline Amendment Tools right-hand panel, click on the View Traditional Amendments button
In the traditional list, see that the text DIFFERENT TEXT now appears in the heading of the new clause amendment and it has overridden the changes you previously made.
Close the traditional list using the Close Editor button
Close the inline document using the Close Editor button
✏️ Removing amendments from the inline document
From the Amendment Manager, select the inline document called Textual amendments and open it in the Editor
In the Inline Amendment Tools right-hand panel, click on the View Traditional Amendments button
In the inline document, open the Inline Amendments right-hand panel and select any amendment, noting down its DNumber
Delete this amendment by clicking on the cross in the bottom right of the amendment card and wait for the amendment to be removed
Save your changes
View the traditional list in the Editor and find the amendment using the DNumber that you deleted in the inline document.
Refresh the browser tab with the traditional list (F5 will refresh the page) and when it reloads, you should see that amendment has been removed
The amendment that was deleted from the inline document has not been deleted from Lawmaker. You can still view it on the Amendment Manager tab.
If you filter the Amendment Manager by List of Draft Amendment’s name and select Textual Amendments, you will see the list of amendments minus the amendment that you had deleted from the list.