Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page provides The pages collected here provide additional information about some of the document check messages which you may see when editing a document.

Warnings

...

about content

Warnings

...

The body of the document is not divided into an even hierarchical structure. This is because not all provisions in the body are wrapped in the same kind of grouping provision (e.g. a Part).

This is an advisory warning which appears when a document contains Parts, Chapters, cross-headings or other grouping headings, and not all of the clauses, sections or paragraphs in the document are included within those groupings.

To investigate the cause of this message, look at the Structure View on the left-hand side of the Editor window. The two screenshots below show document structures which would trigger this warning. Note that the relative indentation of the section numbers and titles in the Structure View indicates whether the section is within or without the preceding Part. In the first, Section 1 appears before the two Parts; in the second, Section 4 appears after Part 1 and before Part 2.

...

This type of document structure is sometimes intentional; where that is the case, the advisory warning can be ignored. If the intention is to include all sections under Part, Chapter, or cross-headings, and a section has simply become misplaced within the document structure, you can correct this by dragging and dropping individual provisions within the Structure View into position inside the relevant grouping headings.

Warnings relating to IDs

Warnings relating to references

The internal reference citation ______ doesn't match the ID of the target provision (______, stored in the href attribute of the reference element). This may mean the citation has not updated correctly or that it has been manually changed. Recreate the reference unless you are sure the current text and attributes are correct.

This advisory warning alerts you to any internal cross-references which may have been changed in a way that will create unexpected results when using the ‘Update x-refs’ function.

Every cross-reference in a document consists of two essential elements: the reference text and the target information. The reference text is the visible text of the reference which appears in the document. The target information is the system’s record of the provision the cross-reference is referencing. As you create new provisions in a document and reorder and renumber existing provisions, the ‘Update x-refs’ action gives you a means of automatically updating the reference text of any internal cross-references which need to be changed as a result of other changes you have made to the document. This action relies on the target information stored in the cross-reference.

For example, if you have created a cross-reference to ‘section 4' and section 4 is subsequently moved elsewhere in the document and renumbered as section 8, the ‘Update x-refs’ action will automatically correct the reference text of your cross-reference so that it instead reads 'section 8’.

However, this functionality won’t work correctly if the reference text and target information go out-of-sync for any reason. This can happen if you manually edit the reference text or change the target information. Where this has happened, this document check reminds you to look at the target information (which appears in brackets in the document check message) and compare it with the text of the reference. If they don’t appear to match and you intend to use the ‘Update x-refs’ action, you should remove the reference tags from the cross-reference (by right-clicking on it and selecting ‘remove reference tag’) and then re-create it using either of the following methods:

  • assuming the text of the reference is correct, and refers to the intended provision, simply select the text and click the ‘Tag x-refs’ button in the toolbar image-20240814-125030.pngImage Removed This will re-create the cross-reference tag with the correct underlying information about its target.

  • if you prefer to manually create the reference, right-click on the relevant target provision in the Structure View, hover over ‘select reference to copy’ in the menu, click on the desired reference form, then highlight the old reference text in your document and press Ctrl+V to paste the newly created reference in its place.

...

about document structure

Warnings about references