Training Module: Drafting amendments inline

Training Module: Drafting amendments inline

Introduction

Inline amendments

Exercises

Getting Started

Before you complete this exercise, you will need a published version of the bill.

For modules within Drafting, submitting and managing amendments, you will need to create a training project containing the following published Bill:
The following steps will allow you to create the data required for this exercise.

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

  2. Log in to Lawmaker.

  3. From the Dashboard, create a new project of the type you need for the exercise. Give it a title such as [Your Initials] Drafting, Submitting and Managing Amendments Bill. (See Creating a new project.)

  4. 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.)

  5. On the newly uploaded document version, select Actions > Update Document Information and update the Title to match the title you originally gave the project.

  6. On the uploaded document version, select Actions > Generate PDF to generate a PDF. (See: Generating and viewing a PDF.)

  7. Select Actions > Publish version on the PDF snapshot version. (See Publishing a Bill document version.)


Exercise 1: Creating textual amendments (leave out, insert and substitute)

This exercise takes you through the process of creating different kinds of amendments inline.

Step 1: Create an inline LoDA

Inline amendments are made within an inline List of Draft Amendments (or “inline LoDA”).

Start by creating a new inline LoDA called Textual amendments for the As Introduced version of the Bill at Consideration Stage. See Creating a List of Draft Amendments (LoDA) .

  1. From the Amendment Workspace tab, click +New.

  2. Select “Inline” as the Type of Amendment.

  3. Select “As Introduced” from the Bill version dropdown menu.

  4. Select “Consideration Stage” from the Stage dropdown menu.

  5. Enter Textual amendments in the List name box.

  6. Click Create.

Step 2: Create some ‘insert' text amendments

In Section 2, within Article 44A, create the following insert text amendments.

image-20250220-133944.png
  1. Place your cursor in the location of the amendment (after “hotel,” in section 44A(1)) and click Enter to view the insert menu

  2. Select Insert text and type a country mansion, into the empty text element

  3. Carry on creating the remaining insert amendments

  4. When you have finished, click the Save icon or press CTRL+S to save your changes.

Step 3: View traditional amendments corresponding to the inline amendments

Every time you save an inline LoDA, Lawmaker updates an associated list containing the traditional form of the amendments in the inline LoDA.

View the traditional amendments and check they match what you were expecting. See Viewing traditional amendments.

  1. From the inline LoDA, open the Inline Amendment Tools panel on the right hand side of the Editor.

  2. Click View Traditional Amendments. A new tab will open containing the traditional amendments corresponding to the amendments in the inline LoDA.

Expected outcome of steps 1-3

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Example of an insert text amendment

image-20250304-120824.png

Example of an amendment with ordinality

image-20250218-163403.png

Example of inserting text at the start of a provision

image-20250218-163413.png

Example of inserting text immediately before punctuation (before the ending full-stop)

image-20250218-163422.png

Close the traditional list of amendments by clicking on the Close Editor button and move to the next step.

Step 4: Create some Leave Out text amendments

In Section 3 create the following 3x leave out text amendments:

image-20250218-165600.png
3 x leave out text amendments
  1. Highlight the text 'in relation' in article 44C(1).

  2. In the toolbar that appears next to the highlighted text, click Leave Out.

  3. Save your changes and then view the traditional amendments to check they match what you were expecting (click View Traditional Amendments in the Inline Amendments Tool panel).

Expected output of step 4

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Example of a leave out text amendment

image-20250304-121124.png

Example of an amendment with ordinality

image-20250218-165134.png

Example of leaving out text that spans over a line

image-20250218-165151.png

Close the traditional list of amendments by clicking on the Close Editor button and move to the next step.

Step 5: Create some Substitute text amendments

In Section 4, create the following 3 x substitute text amendments.

image-20250310-135736.png
  1. Highlight the text “first” and in the hovering tool bar, click on Substitute

  2. Type “second" within the empty text element

  3. Carry on creating the remaining substitute amendments

Save your changes and view the traditional amendments to check they match what you were expecting (click on View traditional amendments button to see the new substitute amendments).

Expected output of step 5

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Substitute a word

image-20250310-135824.png

Substitute a phrase

image-20250305-151558.png

Substitute a single word

image-20250310-135927.png

Leaving out words that span over a line to the end of a line

image-20250310-135954.png

Close the traditional list of amendments by clicking on the Close Editor button and close the inline LoDA by also clicking on the Close Editor button and move to the next exercise.


Exercise 2: Creating structural amendments (leave out, insert and substitute)

This exercise takes you through the process of creating different kinds of amendments inline.

Step1: Create an inline LoDA

Start by creating a new inline LoDA called Structural amendments for the As Introduced version of the Bill at Consideration Stage. See Creating a List of Draft Amendments (LoDA) .

Ensure your renumbering mode is set to “Off” (Tools > Turn on/off renumbering) if you want your inserted provisions numbered correctly.

Step 2: Create some ‘insert' structure amendments

In and around Section 8, create the following 5 x insert amendments.

Inserting a subsection after the first subsection
image-20250220-150953.png
Inserting a new section before section 8
image-20250219-125342.png
Inserting a new section after section 8
image-20250219-125204.png
Inserting a new section after section 9 that is contained within a cross heading

image-20250219-125934.png

image-20250219-125849.png
Inserting a new subsection with child paragraphs in section 7
image-20250219-125040.png
  1. In Section 8, place your cursor anywhere in subsection (1) and click Enter to view the insert menu

  2. Select Subsection and type In Article 42 of that Order (general permitted hours), in each of paragraphs (1) and (2), after "Article 5(1)(b)" insert "or (m)". within the empty text element

  3. Carry on creating the remaining insert amendments

  4. Save your changes and then view the traditional amendments to check they match what you were expecting (click View Traditional Amendments in the Inline Amendments Tool panel).

Expected output from steps 1-2

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Insert a new subsection

image-20250310-141210.png

Insert new clause before

image-20250310-141610.png

Insert new clause after

image-20250310-141726.png

Insert new clause with grouping level (cross heading in this instance)

image-20250310-141759.png

Insert new subsection with child paragraphs

image-20250310-141821.png

Close the traditional list of amendments by clicking on the Close Editor button and move to the next step.

Step 3: Create some ‘leave out' structure amendments

In Sections 10 to 12, create the following 4 x leave out amendments.

Leave out subsection (3)(b) which will include the child quoted structure
image-20250219-132104.png
Leave out Subsection (5) which will include the children paragraphs
image-20250219-132115.png
Leave out section 11
image-20250219-132130.png
Leave out paragraph (c) inside a quoted structure

 

image-20250220-152206.png

 

  1. In Section 10, place your cursor subsection (3)(b) and select ‘Paragraph’ from the breadcrumb to highlight the whole paragraph

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

  3. Complete the remaining leave out amendments

  4. Save your changes and then view the traditional amendments to check they match what you were expecting (click View Traditional Amendments in the Inline Amendments Tool panel).

Expected output for step 3

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Leave out subsection (3)(b) which will include the child quoted structure

image-20250310-142555.png

Leave out Subsection (5) which will include the children paragraphs

image-20250310-142614.png

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

image-20250310-142641.png

Leaving out a provision within a quoted structure

image-20250310-142657.png

Close the traditional list of amendments by clicking on the Close Editor button and move to the next step.

Step 4: Create some ‘Substitute' structure amendments

In Section 13, create the following 2 x substitute amendments.

image-20250219-133516.png
  1. In Section 13, place your cursor in subsection (1) and select ‘Subsection’ from the breadcrumb to highlight the whole provision

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

  3. 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"

  4. Receate the other substitute amendment

  5. Save your changes and then view the traditional amendments to check they match what you were expecting (click View Traditional Amendments in the Inline Amendments Tool panel).

Expected output with brief explanation of the type of amendment created

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Substitute subsection (3) including the child paragraphs and their child quoted structures

image-20250310-143012.png

Substitute subsection (1)

image-20250310-143035.png

Close the traditional list of amendments by clicking on the Close Editor button and close the inline LoDA by also clicking on the Close Editor button and move to the next exercise.


Exercise 3: Creating hybrid amendments (part textual and part structural in composition)

This exercise takes you through the process of creating different kinds of amendments inline.

Step 1: Create an inline LoDA

Start by creating a new inline LoDA called Hybrid amendments for the As Introduced version of the Bill at Consideration Stage. See Creating a List of Draft Amendments (LoDA) .

Step 2: Create some ‘insert' hybrid amendments

In Section 23, create the following 3x insert amendments.

image-20250219-135733.png
  1. In Section 23, place your cursor immediately after the text ‘paragraph (3)’ and click Enter to view the insert menu

  2. Select Insert text and type into the empty text placeholder element

  3. Insert a paragraph and type in sub-paragraph (a), omit "Good Friday or", and

  4. Insert another paragraph and leave the text placeholder empty.

  5. Continue drafting the remaining hybrid amendments.

  6. Save your changes and then view the traditional amendments to check they match what you were expecting (click View Traditional Amendments in the Inline Amendments Tool panel).

Expected output for steps 1-2

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Breaking subsection (2)(a) into 2 paragraphs

image-20250310-143506.png

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.

image-20250310-143528.png

Breaking subsection (4) into paragraphs

Note that the empty Text element will not render in the PDF and when the amendment is auto-applied, the text remaining from the carved up provision will be inserted into paragraph (b)

 

image-20250310-143546.png

Close the traditional list of amendments by clicking on the Close Editor button and move to the next step.

Step 3: Create some ‘leave out' hybrid amendments

In Section 25, create the following 2 x leave out hybrid amendments.

image-20250219-140814.png
  1. In section 25, within Article 26A(1) (in the inserted text), highlight from the word ‘which’ to the end of paragraph (b)

  2. In the hovering tool bar select Leave Out

  3. Create the remaining leave out hybrid amendment

  4. Save your changes and then view the traditional amendments to check they match what you were expecting (click View Traditional Amendments in the Inline Amendments Tool panel).

Expected output for step 3

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Hybrid leave out removing some text and child paragraphs

image-20250310-143751.png

Hybrid leave out which will merge 2 separate subsections into a single subsection

image-20250310-143805.png

Close the traditional list of amendments by clicking on the Close Editor button and move to the next step.

Step 4: Create some substitute hybrid amendments

In section 26, create the following 2 x inline amendments

image-20250220-171027.png

 

  1. In Section 26(5) highlight from ‘paragraph' until ‘in’ in section 26(5)(c)

  2. In the hovering tool bar click on Substitute

  3. Type sub-paragraph (a) and into the empty ‘text’ element

  4. Continue with the other amendment

  5. Save your changes and then view the traditional amendments to check they match what you were expecting (click View Traditional Amendments in the Inline Amendments Tool panel).

Expected output of step 4

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Substitute hybrid that will remove a paragraph

 

image-20250310-144031.png

Substitute hybrid that will result in the removal of 3 paragraphs

image-20250310-144049.png

Close the traditional list of amendments by clicking on the Close Editor button and close the inline LoDA by also clicking on the Close Editor button and move to the next exercise.


Exercise 4: Creating amendments involving cross references

This exercise takes you through the process of creating amendments that involve cross references, either including them in your amendment or amending an existing cross reference as part of your amendment.

Step 1: Create an inline LoDA

Start by creating a new inline LoDA called Cross reference amendments for the As Introduced version of the Bill at Consideration Stage. See Creating a List of Draft Amendments (LoDA) .

Step 2: Create an amendment that edits a cross reference

In section 36, create the following 2 x amendments which are amending existing cross references and involve inserting new marked up cross references

image-20250224-092748.png
  1. In both cases, you need to delete the whole cross reference by highlighting it and selecting Substitute from the Inline Amendment Tools

  2. To insert the marked up cross reference, find the target provision in the structure view

  3. Right-click and select Select reference to copy and select your preferred notation

  4. Back in the Editor, paste the copied cross reference into the ‘Insert text’ element using keyboard shortcut CTRL+V

  5. Create the other amendment

  6. Save your changes and then view the traditional amendments to check they match what you were expecting (click View Traditional Amendments in the Inline Amendments Tool panel).

Expected outcome of step 2

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Substitute a single cross reference

image-20250310-145057.png

Substituting text within a cross reference range

image-20250310-145113.png

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 when these are auto-applied, they will remain as valid cross references (assuming their target provisions aren’t removed by other amendments).

Close the traditional list of amendments by clicking on the Close Editor button and close the inline LoDA by also clicking on the Close Editor button and move to the next exercise.


Exercise 5: Adding proposers and supporters

This exercise takes you through the process of adding or updating proposers and supporters against your amendments.

Step1: Open an inline LoDA

Start by opening the inline LoDA you created most recently called Cross reference amendmenents from the Amendment Workspace tab

Step 2: Manage proposer and supporters in the inline LoDA

Assign a proposer to all the amendments in your inline LoDA

  1. View the Inline Amendment Tools right-hand panel and click on the Manage Members button

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

  3. Click on the Update button

  4. Save your changes and then view the traditional amendments to see the proposers and supporters assigned to each amendment (click View Traditional Amendments in the Inline Amendments Tool panel).

Step 3: Manage proposer and supporters in the traditional LoDA

Assign a different proposer to one amendment and remove the supporters from all amendments

  1. Click on the proposer name for any amendment in your traditional list of draft amendments and in the Manage proposers and supporters change the proposer name

  2. Click on Update button when complete

  1. Select Tools > Update Members… from the upper toolbar

  2. In the Update Members dialog box, leave all amendments to update and select Replace proposer with the selected member

  3. Type a different proposer’s name into the Member(s) input field and click on the Update button

  4. Click on the Update button when complete

  5. Save your changes when complete.

Expected outcome of steps 1 to 3

Type of amendment

Traditional amendment

Type of amendment

Traditional amendment

Different proposers for each amendment and no supporters

image-20250304-140426.png

Tips

  • Create a new inline document per proposer as this 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. Save these sorts of changes to the end so as to avoid any out-of-sync markers in your inline LoDA whilst drafting amendments.

Close the traditional list of amendments by clicking on the Close Editor button and close the inline LoDA by also clicking on the Close Editor button and move to the next exercise.


Exercise 6: Handling out-of-sync amendments

This exercise explains how Lawmaker handles changes made to the traditional amendment which do not backwards sync with the inline LoDA. Warning markers are used to signify when the traditional amendment (which gets submitted) is out of sync with the inline equivalent. It’s possible to remove a warning marker if you are sure you want to overwrite the changes made to the traditional amendment.

Step 1: Open an inline LoDA

Start by opening the recently created inline LoDA called Structural amendmenents from the Amendment Workspace tab

Step 2: Make changes to a traditional amendment

Click on View Traditional Amendments in the Inline Amendments Tool panel and make the following changes to a new clause amendment in the traditional list and save your changes)

Save your changes when complete.

image-20250224-102935.png

Step 3: Attempt to edit the inline amendment

Return to the inline LoDA and attempt to edit the same amendment in the inline LoDA. You will know which one it is as the inline amendment (in the Inline Amendments right-hand panel) will have a warning marker next to it. A warner marker prevents you from unwittingly making edits to an amendment in the inline LoDA if its equivalent traditional amendment has been amended.

image-20250224-101938.png
  1. View the traditional amendments by clicking on View Traditional Amendments in the Inline Amendments Tool panel

  2. Add or remove some text in one of your amendments and save the changes, making a note of the DNumber

  3. Back in the inline LoDA, attempt to type into the amendment you just updated.

  4. Yellow warning messages will advise you that the corresponding amendment in the traditional list has been changed and a black triangle will appear on that amendment card in the Inline Amendments right-hand panel indicating that the inline LoDA is out-of-sync with changes made in the traditional LoDA.

Step 4: Remove the warning marker and overwrite the changes you made to the traditional amendment

In the inline LoDA, remove the black warning marker against the updated amendment before you make further changes to the inline amendment. Save your changes when you’ve finished updating the amendment.

image-20250224-102351.png
  1. In the inline LoDA, view the Inline Amendment right-hand panel and click on the black warning triangle

  2. In the Remove out-of-sync warning marker dialog box click on the Remove button

  3. Add or remove some text from the amendment (this time you will be able to).

  4. Save your changes and go back to the traditional list and see that your recent changes to this list have been overwritten by your more recent changes to the inline LoDA (you might need to refresh your list if you already had the tab open in the browser)

Close the traditional list of amendments by clicking on the Close Editor button and close the inline LoDA by also clicking on the Close Editor button and move to the next exercise.


Exercise 7: Removing amendments from the inline document

Step 1: Open an inline LoDA

Start by opening the recently created inline LoDA called Textual amendmenents from the Amendment Workspace tab

Step 2: Remove an amendment from the inline LoDA

In the inline LoDA, find an amendment, make a note of its DNumber and delete it by clicking on the cross on the amendment card in the Inline Amendments right hand panel.

Save your changes

Click View Traditional Amendments in the Inline Amendments Tool panel and view the traditional amendments to check that the amendment you removed is no longer in the list.

image-20250224-104835.png
  • 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 using the filter option List of Draft Amendment’s name you will see the list of amendments minus the amendment that you had deleted from the list.

Close the traditional list of amendments by clicking on the Close Editor button and close the inline LoDA by also clicking on the Close Editor button and move to the next exercise.


When complete…

Move to Training Module: Drafting traditional amendments