LogoLogo
ClausesDatafieldsSpecial FunctionsStylingQ&AAPI
  • Welcome!
  • Getting started
    • What is Clause9?
    • Structuring your clause library
    • Structuring your clauses
    • Drafting modes in Clause9
    • Creating a questionnaire
    • Sample clauses
    • Videos
      • Concepts and datafields
      • Conditions
      • Q&As
      • Binders
      • Styling
      • Enumerations
      • Tables
      • Definitions
      • Snippets
      • Cross-references
      • Special functions
      • Examples of common clauses
      • Import clauses from MS Word
      • Grammatical conjugations
      • Action buttons
      • Alternative clauses
  • Assemble document
    • Document toolbar
    • Clause hierarchies
    • Focus Mode
    • Bulk generation of documents
    • Exporting documents
    • Assemble Document - FAQ
    • How to: Assemble Document
      • Insert images
  • Assemble Document Operations Panel
    • Operations panel
    • File pane
    • Edit pane
    • Document pane
    • Binder pane in the operations panel
    • Search pane
    • Browse pane
    • Terms pane
    • Data dashboard
    • Advanced pane
    • Styling pane
    • Miscellaneous pane
    • Visibility settings & actions menu
  • Binders
    • Binders: general
    • Styling cross-references to subdocuments
    • Global and local definition lists
    • Document and binder properties
    • Styling of a Binder versus subdocuments
    • (Un)locking documents in a binder
    • Binders - FAQ
    • How to: binders
      • Make a subdocument in a binder conditional
  • Clauses
    • Introduction to clauses
    • Clause structure
    • Grammar sheet
    • Writing conditions
    • Examples of conditions
    • Using codes instead of text fragments
    • Bold, italic and underline
    • Special codes
    • Enabled?
    • Links
    • Cross-references
    • Introduction to tables
    • Deviating table styling
    • Shrinking clauses
    • Action buttons
    • Enumerations
    • File position
    • Snippets
    • Parameters
    • Conjugations
    • Mixing data types
    • For-loops
    • Clause versioning
    • Abstract article references
    • Advanced multi-language features
    • Clauses - FAQ
    • How to: clauses
      • Create an ad-hoc clause
      • Create a library clause
      • Make a clause repeat
      • Make a paragraph within a clause conditional
      • Use a shortcut to refer to a concept
      • Insert a line break or page break
      • Creating a list with both predefined options and free input
      • Defining alternative clauses
      • Creating cross-references
      • Creating signature blocks
      • Creating advanced party introduction clauses
      • Automatically numbered annexes or schedules
      • Reuse any clause in a different context
      • Setting MS Word document properties
      • Add action buttons to clauses
      • Electronically signing documents
  • concepts
    • Introduction to concepts
    • Creating concepts
    • Concept labels
    • Links
    • Organising concepts
    • Concepts - FAQ
    • How to: concepts
      • Add predefines to a datafield
  • Datafields
    • Introduction to datafields
    • Types of datafields
    • Rules of thumb for using datafields
    • Data-expressions
    • Datafield aliases
    • Datafield labels
    • Datafield special tags
    • Datafield descriptions
    • Repeating list datafields
    • Datafield predefines
    • Datafields - FAQ
    • How to: datafields
      • Change datafield type
      • Change the datafield's name or alias
  • Definitions
    • Introduction to definitions
    • How to: definitions
      • How do definitions work?
      • Create a definition
  • Files
    • How files are organised
    • Browse files
    • File types
    • Custom styling
    • Legal comments
    • File description
    • Attributes
    • Reporting
    • File name
    • File category
    • Access rights
    • How to: files
      • Creating advanced folders
      • Naming your files
      • Shortcuts to folders or files
  • Q&A
    • About cards
    • Cards pane
    • About changes
    • Changes pane
    • Types of changes
    • Adding conditions
    • Question options
    • Copying & pasting answers
    • Comments, notes & documentation
    • Interactive Q&A inspection
    • Embedding questions into a document
    • “Changes” button
    • Batch create pane
    • Identifiers pane
    • Import pane
    • Edit clauses pane
    • Q&A options
    • Q&A - FAQ
    • How to: Q&A
      • Create predefined answers to a question
      • Add disclaimers
      • Create categories of questions
      • Modify the exported filename
      • Create a question to change the language of a document
      • Send a questionnaire to someone without a ClauseBase account
      • Create questions for repeating list datafields
      • Selecting legal entities & addresses
      • Create a questionnaire using "batch create"
      • Launch other Q&As
    • Leveraging ClauseBuddy Smart Templates in Clause9
  • Import
    • Introduction to importing clauses
    • Uploading clauses
    • Defined terms in Import mode
    • Datafields in Import mode
    • Cross-references in Import mode
    • Assigning folders
    • Conversion process
    • Exporting
    • Stashing intermediate results
    • Tips, tricks & limitations
  • Styling
    • Styling overview
    • Base styling
    • Numbering
    • Definitions styling
    • Enumerations styling
    • Locale styling
    • References styling
    • Page styling
    • Styling of a Binder versus subdocuments
    • Styling: tips and tricks
    • Advanced styling topics
    • Copying headers and footers from an MS Word file
    • How to: styling
      • Using custom fonts
      • Change bullet styling
  • Special functions
    • Introduction
    • Calculations
    • Concepts
    • Conditions
    • Conjugations
    • Content Control Elements
    • Datafields
    • Dates & durations
    • Languages
    • Lists
    • Numbers
    • References
    • Repeating (looping)
    • Special items
    • Text structure
    • Text modification
    • User
    • Q&A
  • Settings
    • Account
    • Preferences
    • Access bundles
    • Favourites
    • Saved searches
    • Saved datafields
    • Styles
    • Default styles
  • Admin
    • General
    • Users
    • User rights
    • Profiles
    • Groups
    • Styles
    • Default styles
    • Attribute models
    • Usage page
    • Custom homepage
    • Global placeholders
    • Access rights
    • How to: admin
      • Adding a new user
      • Disabling a user
      • Managing group memberships
  • Miscellaneous
    • Advanced tips & tricks
    • Typing special symbols on your keyboard
    • Shortcuts
    • Grammar style guide
    • Inserting MS Word files
    • Globo-panel
    • Creating high-quality documents
    • Excel calculations and lookups
  • Integrations
    • Overview
    • Spreadbases
    • E-signing documents
    • Drag & drop integrations
  • For developers
    • Clause9 API
    • Custom functions
    • Example custom functions
Powered by GitBook
On this page
  • Short comments
  • Help texts for cards/questions/predefined answers
  • Clause comments
  • References to databases with case law / legal doctrine
  • References to external websites (Q&A)
  • Comment & warning blocks in a Q&A
  • Memo files
  • Creating a memo file
  • Attaching memo files to clauses
  • Attaching memo files to questions
  • Attaching memo files to cards
  • Attaching memo files to predefined answers
  • Showing memo files
  • Exporting memo files
Export as PDF
  1. Q&A

Comments, notes & documentation

PreviousCopying & pasting answersNextInteractive Q&A inspection

Last updated 1 year ago

Clause9 provides many different ways to provide assistance towards the end-user, both in a Q&A and in the Assemble Document mode.

  • Every clause, card, question and predefined answer can have an associated short comment. Such short comment will be displayed in a popup-balloon.

  • Every clause can also have an reference to another online database (e.g., with case law or jurisprudence).

  • Instead of regular text, a short comment in a Q&A can also contain the address (URL) of an external website. This external website will then be shown at the right side of a Q&A.

  • In a Q&A, you can insert dedicated comments and warnings, as separate visual elements in the questionnaire.

  • Every clause, card, question and predefine can also be associated with a separate memo file. Such memo files can contain multiple paragraphs — or even multiple pages — of in-depth documentation.

Short comments

Short comments can be added to both individual clauses and to a Q&A’s cards, questions and predefined answers.

You can also add short comments to a Document or Binder itself, which can be useful if you want to provide comments about the Document/Binder in general. Note however that these Document/Binder-level short comments will not be exported in any way.

Help texts for cards/questions/predefined answers

To guide end-users when completing a questionnaire, you can attach a subtle help text to a question and predefined answer. This text will deliberately not be shown permanently: the end-user must hover above the question-mark icon in order to see the help text.

To attach such help text:

  • to a question, click on the question’s options, and insert your text within the “Help text”:

The comment will then show up as a question mark next to the question:

  • to a predefined answer, click on the question mark to the right of the predefine answer:

The comment will then show up next to the predefined answer:

Tip: the help text can include placeholders, which can then be dynamically replaced by other text. To do so, use ?PLACEHOLDER in the text, and insert a Change placeholder change to change the placeholder to something else (e.g., the answer to a certain question).

Clause comments

Clause comments are ideal to insert short notes about a certain clause — e.g. the source of the clause, some warnings on how to (not) use the clause, or perhaps short references to case law or legal doctrine about this clause.

When clause comments are available, a small information-icon will show up to the left of the clause:

  • In a Q&A, the information-icons are not visible by default. You will have to enable them by inserting a “Change various Q&A options” change, suboption “Show short comments attached to clauses?”. (As always, you can subject such changes to conditions, e.g. to only show the information-icons for some types of users).

Inserting clause comments

To insert a short comment in a clause, open the clause for editing and show the Notes subpane (first click on the + more button).

Next, click on “Short comment”:

Finally, click on any of the available languages and start typing to actually insert the comment.

If “Never export” is checked, the comment will never be exported to MS Word / PDF. This allows you to selectively skip certain comments from ending up in the DOCX/PDF files.

Exporting clause comments

When exported, clause comment (except those for which “Never export” was checked) will show up as popup balloons in MS Word:

However, this export must be explicitly enabled:

  • In Assemble Document, you have to click the wrench-icon in the toolbar, and check “export comments”.

  • In a Q&A, you have to insert a “Change the save / export settings” change, and enable the “Export comments” option. (You may want to subject this change to a condition, or couple it to a question in the questionnaire, to define the situations in which the comments should (not) be exported).

References to databases with case law / legal doctrine

For each clause, you can insert one or more references to separate (legal) knowledge bases — e.g., containing in-depth discussions in legal doctrine, or case law about the contents of the clause, or perhaps official websites.

To insert such a reference, open the clause for editing and show the Notes subpane (first click on the + more button).

Next, click on “External link”:

These references will show up as (the last part of) a clause comment, and will be exported as such. See the section above on clause comments to learn how to enable/disable their visibility, and how to export them to MS Word.

References to external websites (Q&A)

Please be aware that, for security (anti-spoofing) reasons, many websites will refuse to be shown inside another website (i.e., technically speaking, within an “IFRAME”). You should check with the webmaster of the target website if the website refuses to be shown at the right side.

Comment & warning blocks in a Q&A

Instead of using a help text or external website / PDF, you can also insert a comment or warning (which are separate types of “questions”). Unlike the help texts, comments and warnings can be subjected to conditions on when they should be shown — but if these conditions are met, they will be constantly visible on the screen.

To insert a comment or warning block, simply insert a question of type “Comment” or “Warning”. The difference between these two is the color displayed towards the user:

Memo files

Memo files allow you to centralise your comments/documentation, to foster reuse across different clauses and Q&As. They are intended for multi-paragraph comments, or even multiple pages of in-depth documentation about a certain subject — even accompanied by subtitles and tables if you want.

Creating a memo file

A memo file is a separate type of file, which you can create in Browse files:

As is the case with any file, you can assign a name to a memo. Please note that this filename will show up on the screen towards the end-user.

The most important setting in this file is the “memo” pane, in which you can then insert formatted text, if preferred in multiple languages.

This editor works in a similar way as most other editors you can find online. A few interesting notes:

Attaching memo files to clauses

To attach a memo file to a clause, show the Notes pane of the clause editor (you may have to click on the + More… button).

Next, click on Link to memo:

Next, you will have to select the memo file you want to attach to the clause.

Note that you can attach multiple memo files to a single clause. Also, you can attach a single memo file to multiple clauses (and/or multiple cards/questions/predefined answers). The underlying idea is that you should centralise your knowledge, and reuse it as much as possible across your entire library.

If “Never export” is checked, the contents of the memo will never be exported to MS Word / PDF. This allows you to selectively skip certain memos from ending up in the DOCX/PDF files.

You can also add memos to a Document or Binder itself, which can be useful if you want to provide extensive comments about the Document/Binder in general. Note however that these Document/Binder-level memos will not be exported in any way.

For performance reasons, memo files (which can easily contain hundreds of kilobytes) are deliberately not loaded together with the document/binder/Q&A they are associated with. Instead, they will be separately fetched from the server at the moment the user clicks on a button to read the memo.

Unlike other content that is part of a document/binder/Q&A (which is always loaded in one batch from the server, so that no separate security checks are performed beyond having the right to receive the document/binder/Q&A), you should be aware that the user should have the right to read the memo. If, for example, a Q&A is stored in a group library, but the memo files are stored in various personal folders, then users will receive errors when trying to read the memos.

Attaching memo files to questions

To attach a memo file to a question, click on the green “+ Memo” button in the question’s options, and subsequently select the memo file.

Attaching memo files to cards

To attach a memo file to a question, click on the green “+ Memo” button in the card’s options, and subsequently select the memo file.

Attaching memo files to predefined answers

To attach a memo file to a predefined answer, click on the question mark to the right of the predefined answer. Next, click on the green “+ Memo” button and select the memo file.

Showing memo files

In Assemble Document, memo files attached to a clause show up as (part of a) clause comment, under the blue information-icon. (In Assemble Document, this visibility is enabled by default. The comments can be hidden, however, through the “…” menu at the right — see submenu Visibility).

When you then click on the title or icon of the memo file, the memo will be shown in the right part of the screen.

In a Q&A, the information-icons are not visible by default. You will have to enable them by inserting a “Change various Q&A options” change, suboption “Show short comments attached to clauses?”. (As always, you can subject such changes to conditions, e.g. to only show the information-icons for some types of users).

If a memo file is attached to card, question or predefined answer, then it will show up as a separate icon on which the user can click. If clicked, the memo is then shown at the right bottom side of the screen:

Exporting memo files

When exported, memo files end up as footnotes in the PDF / DOCX file. (The reason is that these memo files can be multiple paragraphs long and/or include tables/subtitles/etc., which is not suitable for comment popup-balloons.)

However, exporting of comments should be enabled first. Please see exporting comments above.

Tip: if the help text is merely intended to warn the user about the unit of measurement (i.e., that the answer should be assumed to be a percentage, or expressed in work days instead of calendar days, or provide a certain number of centimeters), you may instead want to use the of each question.

In Assemble Document, this visibility is enabled by default. The comments can be hidden, however, through the menu at the right (see submenu Visibility).

Instead of a simple text balloon, you can also show external websites or PDF files, simply by inserting the URL of that website or PDF file into the help box of a card, question or predefined answer. The contents will then be shown on the right side of the browser window when the user clicks the question-mark icon. For example, when setting the help-text of the “First Name” to , the following would be shown:

https://help.clause9.com/assemble-document/focus-mode
suffix option