Laws.Africa Editor Guide
English
English
  • Welcome
  • Getting started
    • Lesson plan
    • Signing up
    • Digitising legislation
    • What is Akoma Ntoso
    • Terminology guide
  • Managing Works
    • Creating and editing works
      • Working with commencements
    • Deleting a document
    • Amending works
      • Creating the amending work
      • Linking the amendment
      • Creating a new document at the new point in time
      • Applying the amendments
      • Annotating the amendments
      • Example
      • Exercise
      • Consolidating the annotations
        • Simple example
        • Complicated example
    • Bulk imports (spreadsheet)
  • How-tos
    • Tasks
    • Importing a document
      • The importer
    • Cleaning up an import
    • Going back to a previous version of a document
    • Fixing all-caps headings
    • Working with tables
      • Table errors
    • Working with links
    • Working with italicised terms
    • Inserting an image
    • Inserting special characters
    • Resolving editor warnings
    • Making comments
    • Inserting editorial notes
    • Changing a document's date
    • Changing a document's short title or language
    • Search and rescue
    • How to handle different language documents
    • How to mark up defined terms which do not occur in a Definitions section
    • Very complicated amendments
      • Research
      • Undo some amendments?
      • Update the timeline
      • Create the tasks
      • Apply the amendments
  • Markup guide
    • Introduction
    • Marking up the structure
    • Preface, Long title, and Preamble
    • Headings
    • Marking up Schedules / Annexes
    • Marking up annotations
    • Marking up tables
    • Marking up links
    • Marking up images
    • Marking up footnotes
    • Marking up formatting
    • Marking up insertions and deletions
    • Keyword reference
  • Reviewing a document
    • Reviewing a document
    • Reviewer checklist
    • Signing off a work
  • Style Guides
    • Laws.Africa
    • Côte d'Ivoire
    • Ghana
    • Namibia
      • Regulations
    • Lesotho
    • Malawi
    • Nigeria
    • Zambia
    • South African Acts
    • South African By-laws
    • Tanzania
    • Uganda
    • UNEP
    • Zimbabwe
    • Seychelles
    • Mauritius
    • Pan-African Parliament/ AGP
    • Turks and Caicos
    • Papua New Guinea
    • eSwatini
    • Rwanda
    • Documents in languages other than English
  • Administration
    • Site settings
    • Managing administrators
    • Countries and localities
    • Document subtypes
    • Task labels
    • Taxonomies
    • Notion templates
Powered by GitBook
On this page
  • Marking up insertions
  • Example
  • Marking up deletions
  • Example
  • Extra markup
  • Exercise
  1. Markup guide

Marking up insertions and deletions

Showing the changes that have been made when one principal work amends another.

PreviousMarking up formattingNextKeyword reference

Last updated 8 months ago

After working through this section, you should be able to:

  • Mark up insertions

  • Mark up deletions.

Marking up insertions

The pattern for marking up insertions is as follows:

  • Before the inserted text, the opening {{+ (note the space after the +)

  • The inserted text

  • The closing }}.

If the inserted text starts with a space, simply add a second space after the +.

Example

  All decisions taken should be reported to the Bureau, the {{+ Open-ended}} Working Group and to the next meeting of the Conference of the Parties.

Will look like this in View mode:

While {{+ insertions}} and __underlines__ look the same in View mode, they just happen to both be styled with an underline for now.

If the style for insertions is updated to a double underline to set them apart from normal underlines, only {{+ insertions}} will be updated.

Marking up deletions

The pattern for marking up deletions is as follows:

  • Before the deleted text, the opening {{- (note the space after the -)

  • The inserted text

  • The closing }}.

If the deleted text starts with a space, simply add a second space after the -.

Example

  The Secretariat shall {{- consult with}}

Will look like this in View mode:

Extra markup

In some jurisdictions, extra markup is included in the original: for example in South Africa, deletions are given [in bold and with braces]. In cases like these:

  • Ignore the bold — we could always update the style for deletions to be bold rather than strikethrough.

  • Leave in the braces, and include them outside the struckthrough text: [{{- remove this}}].

Exercise

Copy the text below and paste it into a practise document, then see the instructions that follow.

A letter of agreement Memorandum of Understanding has been signed between the secretariat of the Basel Convention and the UNEP/OCHA Environmental Unit, identifying the areas and the methodology for cooperation.
  1. Mark up letter of agreement as an insertion.

  2. Mark up Memorandum of Understanding as a deletion.

When you're done, it should look like this in View mode:

and like this in Edit mode:

A {{+ letter of agreement}} {{- Memorandum of Understanding}} has been signed between the secretariat of the Basel Convention and the UNEP/OCHA Environmental Unit, identifying the areas and the methodology for cooperation.