1.2. GDA single-point-of-truth

The aim of this document, and the GDA User Guide, is to be the single definitive location of GDA information. Providing developers and users with a single starting point to obtain GDA information, rather than distributing this throughout myriad Confluence pages that are difficult for a reader to navigate sequentially and measure the relevance of the information they contain.

Information contained in Confluence pages is being migrated to the Guides. Once a Confluence page is migrated its contents will be deleted/replaced with a link to the Guide location the information has been migrated to. During this process it may be necessary to link from a Guide page to a Confluence page, e.g. where Confluence page A has been migrated but a page B, it linked to, has not yet been migrated, the newly migrated A` will contain a link to the yet-to-be migrated Confluence page B. Obviously, if page A links to page C that contains out-of-date or irrelevant information, the link to this page will not be migrated to A`.

Links to Diamond Jira and Confluence pages are formatted to include their respective Atlassian icon, in order to make them easily recognisable to the reader, e.g. Jira DAQ issues and Confluence Data Acquisition Home . (The mechanism used to provide this formatting is the same as used in the formatting of links to source code documentation, see section External links to source code documentation .)

N.B. As of end-of 2019 Diamond Confluence pages are no longer available publicly, i.e. if browsing the publicly available version of this or GDA User Guide from outside of the Diamond network, the Confluence pages will not be accessible.