Versions Compared

Key

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

...

To investigate the cause of this message, look at the Structure View on the left-hand side of the Editor screenwindow. The two examples 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. (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.)

...

This type of document structure is sometimes intentional; in those cases where that is the case, the advisory warning can be ignored. If however 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 drag and drop correct this by dragging and dropping individual provisions within the Structure View into position below inside the relevant grouping headingheadings.

Warnings relating to IDs

...

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 draft create new provisions in a document and reorder and periodically renumber its existing provisions, the ‘Update x-refs’ action allows you to update gives you a means of automatically updating the reference text of any internal cross-references automatically, based 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’ve 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 change edit the reference text of a reference or deliberately alter change the target information. Where this has happened, this document check reminds you to check 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.png 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 and , hover over ‘select reference to copy’ in the menu, click on the correct desired reference form to copy it to your clipboard, then highlight the old reference text in your document and press Ctrl+V to paste the newly created reference in its place.

...