Dyalog · FionaDyalog · Nov 5, 2025 · Nov 5, 2025
diff --git a/earlier-release-notes/docs/release-notes-v19-0/index.md b/earlier-release-notes/docs/release-notes-v19-0/index.md
@@ -1,7 +1,3 @@
 # About This Document
 
-## Audience
-
-## Conventions
-
-Unless explicitly stated otherwise, all examples in Dyalog documentation assume that `⎕IO` and `⎕ML` are both 1.
+This document describes the changes and new features in Dyalog version 19.0 compared with Dyalog version 18.2.
diff --git a/earlier-release-notes/mkdocs.yml b/earlier-release-notes/mkdocs.yml
@@ -46,6 +46,7 @@ markdown_extensions:
       title: On this page
 nav:
   - Dyalog v19.0 Release Notes:
+    - release-notes-v19-0/index.md
     - Introduction:
         - Key Features: release-notes-v19-0/introduction/key-features.md
         - Extension to Native File Functions: release-notes-v19-0/introduction/extension-to-native-file-functions.md

diff --git a/interface-guide/docs/index.md b/interface-guide/docs/index.md
@@ -1,7 +1,5 @@
 # About This Document
 
-## Audience
+This document describes various interfaces between Dyalog and Microsoft Windows, including the Multiple Document Interface (MDI) and docking, the Component Object Model (COM) interface, and other Microsoft Windows applications. It also describes the underlying concepts, implementation rules, and graphical resources available when creating a user interface using Dyalog.
 
-## Conventions
-
-Unless explicitly stated otherwise, all examples in Dyalog documentation assume that `⎕IO` and `⎕ML` are both 1.
+This document should be read in conjunction with the [_Dyalog for Microsoft Windows Object Reference Guide_](../object-reference/).
diff --git a/interface-guide/mkdocs.yml b/interface-guide/mkdocs.yml
@@ -46,6 +46,7 @@ markdown_extensions:
   - toc:
       title: On this page
 nav:
+  - index.md
   - Introduction:
       - Overview: introduction/overview.md
       - Concepts: introduction/concepts.md

diff --git a/language-reference-guide/docs/index.md b/language-reference-guide/docs/index.md
@@ -1,7 +1,5 @@
 # About This Document
 
-## Audience
+This document details the individual elements that form the 'vocabulary' of the APL language. It explains every primitive function, primitive operator, system function, and system command in Dyalog.
 
-## Conventions
-
-Unless explicitly stated otherwise, all examples in Dyalog documentation assume that `⎕IO` and `⎕ML` are both 1.
+It is assumed that the reader has a reasonable understanding of mathematics.
diff --git a/language-reference-guide/mkdocs.yml b/language-reference-guide/mkdocs.yml
@@ -48,6 +48,7 @@ markdown_extensions:
   - toc:
       title: On this page
 nav:
+  - index.md
   - Key to Notation: key-to-notation.md
   - Glyphs: glyphs.md
   - Primitive Functions:

diff --git a/net-framework-interface-guide/docs/index.md b/net-framework-interface-guide/docs/index.md
@@ -1,7 +1,5 @@
 # About This Document
 
-## Audience
+This document describes the Dyalog interface to the Microsoft .NET Framework. The information provided in this document does not explain the features of the .NET Framework, but concentrates on explaining the APL interfaces that sit between the .NET Framework and the APL Session.
 
-## Conventions
-
-Unless explicitly stated otherwise, all examples in Dyalog documentation assume that `⎕IO` and `⎕ML` are both 1.
+It is assumed that the reader has is familiar with the .NET Framework and has a basic understanding of OO methodologies.
diff --git a/net-framework-interface-guide/mkdocs.yml b/net-framework-interface-guide/mkdocs.yml
@@ -46,6 +46,7 @@ markdown_extensions:
   - toc:
       title: On this page
 nav:
+  - index.md
   - Overview:
       - Introduction: overview/introduction.md
       - Prerequisites: overview/prerequisites.md

diff --git a/object-reference/docs/index.md b/object-reference/docs/index.md
@@ -1,7 +1,5 @@
 # About This Document
 
-## Audience
+This document describes the complete set of objects, properties, events, and methods through which Dyalog supports the creation of a Graphical User Interface.
 
-## Conventions
-
-Unless explicitly stated otherwise, all examples in Dyalog documentation assume that `⎕IO` and `⎕ML` are both 1.
+This document should be read in conjunction with the [_Dyalog for Microsoft Windows Interfaces Guide_](../interface-guide/).
diff --git a/object-reference/mkdocs.yml b/object-reference/mkdocs.yml
@@ -45,6 +45,7 @@ markdown_extensions:
   - toc:
       title: On this page
 nav:
+  - index.md
   - GUI Overview:
       - GUI Overview: gui-overview/guioverview.md
       - Objects Categorised: gui-overview/objects-categorised.md

diff --git a/programming-reference-guide/docs/index.md b/programming-reference-guide/docs/index.md
@@ -1,7 +1,3 @@
 # About This Document
 
-## Audience
-
-## Conventions
-
-Unless explicitly stated otherwise, all examples in Dyalog documentation assume that `⎕IO` and `⎕ML` are both 1.
+This document details the syntax that forms the 'grammar' of the APL language. It describes the viable values that can be used in expressions, and explains how the individual language elements can be manipulated through defined functions and operators, control structures, and object oriented programming, as well as the way in which multi-threading can be implemented.
diff --git a/programming-reference-guide/mkdocs.yml b/programming-reference-guide/mkdocs.yml
@@ -45,6 +45,7 @@ markdown_extensions:
   - toc:
       title: On this page
 nav:
+  - index.md
   - Introduction:
       - Workspaces: introduction/workspaces.md
       - Legal Names: introduction/names.md

diff --git a/unix-installation-and-configuration-guide/docs/index.md b/unix-installation-and-configuration-guide/docs/index.md
@@ -1,7 +1,5 @@
 # About This Document
 
-## Audience
+This document covers the installation procedure and configuration options for Dyalog on a Unix-based platform. It details the environment variables that can be used to customise individual instances, the requirements for using the PuTTY terminal emulator, and the upgrade and uninstall procedures.
 
-## Conventions
-
-Unless explicitly stated otherwise, all examples in Dyalog documentation assume that `⎕IO` and `⎕ML` are both 1.
+It is assumed that the reader has a basic knowledge of UNIX and software terminology; a working knowledge of Dyalog is useful but not essential.
diff --git a/unix-installation-and-configuration-guide/mkdocs.yml b/unix-installation-and-configuration-guide/mkdocs.yml
@@ -45,6 +45,7 @@ markdown_extensions:
   - toc:
       title: On this page
 nav:
+  - index.md
   - Introduction: introduction.md
   - Installing Dyalog APL: installation.md
   - Dyalog Serial Number: dyalog-serial-number.md

diff --git a/windows-installation-and-configuration-guide/docs/index.md b/windows-installation-and-configuration-guide/docs/index.md
@@ -1,7 +1,5 @@
 # About This Document
 
-## Audience
+This document covers the installation procedure and configuration options for Dyalog on the Microsoft Windows operating system. It details the parameters that can be used to customise individual instances, the creation of executables and run-time applications, use of the command line, and the Dyalog Dynamic Link Library, as well as describing the recovery process if a system error is encountered.
 
-## Conventions
-
-Unless explicitly stated otherwise, all examples in Dyalog documentation assume that `⎕IO` and `⎕ML` are both 1.
+It is assumed that the reader has a basic knowledge of Microsoft Windows and software terminology; a working knowledge of Dyalog is useful but not essential.
diff --git a/windows-installation-and-configuration-guide/mkdocs.yml b/windows-installation-and-configuration-guide/mkdocs.yml
@@ -45,6 +45,7 @@ markdown_extensions:
   - toc:
       title: On this page
 nav:
+  - index.md
   - Documentation: documentation.md
   - Files and Directories: files-and-directories.md
   - File Extensions: file-associations.md

diff --git a/windows-ui-guide/docs/index.md b/windows-ui-guide/docs/index.md
@@ -1,7 +1,5 @@
 # About This Document
 
-## Audience
+This document introduces the Dyalog user interface. It describes the windows, menu options, built-in tools, and customisation possibilities that are available when running Dyalog on the Microsoft Windows operating system, and explains the programming techniques, file storage mechanisms, integrity checking features, and error trapping concepts available with Dyalog.
 
-## Conventions
-
-Unless explicitly stated otherwise, all examples in Dyalog documentation assume that `⎕IO` and `⎕ML` are both 1.
+It is assumed that the reader has a basic understanding of software terminology.
diff --git a/windows-ui-guide/mkdocs.yml b/windows-ui-guide/mkdocs.yml
@@ -46,6 +46,7 @@ markdown_extensions:
   - toc:
       title: On this page
 nav:
+  - index.md
   - Introduction: introduction.md
   - APL Keyboards: apl-keyboards.md
   - Session Manager: session-manager.md