The use case for listing who transcludes is to to keep track of which document uses content of a given document. If text is changed it is easy for the author to find the transcluding documents. With the list of transcluding documents the author can quickly check if the change on the transcluded contents also requires changes on the transcluding documents. If readers find a module by search they can quickly check in which documents this topic is used and find additional information in related documents.

The Module doctype provides a section named Transcluded by to show which documents use contents of this module.

This section lists all documents that transclude contents from this module.

The Where clause reads:

$<TranscludedDocumentTitles>=[${Space Key}.${Title}]

The query selects all documents that contain the space key and title (in a special format SpaceKey.PageTitle) in their list of pages they transclude from.

$<TranscludedDocumentTitles>=[TWO.C]

In case a document takes advantage of transcluding contents from existing documents, the authors may decide to add a list of references to these documents explicitly at the end of the document. This could be done in the References section. Together with the name of the documents and a link the list can also render the Short Description, making it even easier for the reader to understand what the referenced information is about before clicking on the link.

With version 3.0.3 of the projectdoc Toolbox a new artificial property named Page Key will be provided. This page key has the form SpaceKey.PageTitle. It allows to uniquely reference a page within a Confluence server as does the numerical page ID. While page IDs may change, for instance due to export and import of a space, the tupel space key and page title does not. The page key is controlled by the user, while the page ID is not.

With this new artificial property the following query can be specified.

$<Page Key>~(${TranscludedDocumentTitles})

It searches all pages whose page key is part of the current document's transclusion list.

$<Page Key>~(ONE.B, TWO.C)