twinbasic · KubaO · May 16, 2026 · May 16, 2026 · May 16, 2026 · May 16, 2026
diff --git a/WIP.md b/WIP.md
@@ -443,6 +443,11 @@ build.bat && check.bat
 
 Requires `build.bat` to have produced an up-to-date `_site/`.
 
+The build itself includes an additional guard: `_plugins/nav-integrity-check.rb` runs during the GENERATE phase and aborts the build if any nav-visible page has a `parent:` (or `parent:` + `grand_parent:`) that does not resolve to exactly one page in the nav tree. It catches two failure modes:
+
+- **Ambiguity** — multiple pages share the title declared in `parent:` and `grand_parent:` is either absent or insufficient to disambiguate. The page would silently appear under every matching parent.
+- **Orphan** — no page has the title declared in `parent:`. The page would silently disappear from the navigation sidebar.
+
 ## Repository Use
 
 Favor concise one-line git commit messages.

diff --git a/docs/Features/Packages/Creating a TWINPACK package.md b/docs/Features/Packages/Creating a TWINPACK package.md
@@ -1,6 +1,6 @@
 ---
 title: Creating a TWINPACK Package
-parent: Packages
+parent: Package Management
 grand_parent: Features
 nav_order: 1
 permalink: /Features/Packages/Creating-TWINPACK

diff --git a/docs/Features/Packages/Importing a package from TWINSERV.md b/docs/Features/Packages/Importing a package from TWINSERV.md
@@ -1,6 +1,6 @@
 ---
 title: Importing a Package from TWINSERV
-parent: Packages
+parent: Package Management
 grand_parent: Features
 nav_order: 2
 permalink: /Features/Packages/Importing-TWINSERV

diff --git a/docs/Features/Packages/Importing a package from a TWINPACK file.md b/docs/Features/Packages/Importing a package from a TWINPACK file.md
@@ -1,6 +1,6 @@
 ---
 title: Importing a Package from a TWINPACK File
-parent: Packages
+parent: Package Management
 grand_parent: Features
 nav_order: 3
 permalink: /Features/Packages/Importing-TWINPACK

diff --git a/docs/Features/Packages/Linked Packages.md b/docs/Features/Packages/Linked Packages.md
@@ -1,6 +1,6 @@
 ---
 title: Linked Packages
-parent: Packages
+parent: Package Management
 grand_parent: Features
 nav_order: 5
 permalink: /Features/Packages/Linked

diff --git a/docs/Features/Packages/Updating a package.md b/docs/Features/Packages/Updating a package.md
@@ -1,6 +1,6 @@
 ---
 title: Updating a Package
-parent: Packages
+parent: Package Management
 grand_parent: Features
 nav_order: 4
 permalink: /Features/Packages/Updating

diff --git a/docs/Features/Packages/index.md b/docs/Features/Packages/index.md
@@ -1,5 +1,5 @@
 ---
-title: Packages
+title: Package Management
 parent: Features
 nav_order: 6
 permalink: /Features/Packages/
@@ -8,14 +8,16 @@ redirect_from:
   - /Packages/What-Is
 ---
 
-# Packages
+# Package Management
 
 In twinBASIC, a *package* is a collection of components that you can reference from another twinBASIC project.  The components can be modules, classes or interfaces.
 
+twinBASIC comes complete with a package manager service called TWINSERV[^1], allowing you to share and distribute TWINPACK packages to other twinBASIC developers.
+
 A twinBASIC package is distributed as a TWINPACK file that contains everything needed by the components in that package.  A project that references a TWINPACK package, imports the whole package into the file system of the root project, resulting in no external dependencies.
 
 With TWINPACK packages you group common components together into their own namespace whilst allowing for convenient code reuse without any of the problems often associated with using external DLL libraries.
 
-twinBASIC comes complete with a package manager service called TWINSERV, allowing you to share and distribute TWINPACK packages to other twinBASIC developers.
+Please be aware that TWINPACK files currently contain the full source code of your packaged components.  It is planned that we will in future allow for creating binary (compiled) TWINPACK files for developers that hold an Ultimate edition licence of twinBASIC.
 
-Please be aware that TWINPACK files currently contain the full sourcecode of your packaged components.  It is planned that we will in future allow for creating binary (compiled) TWINPACK files for developers that hold an Ultimate edition licence of twinBASIC.
+[^1]: A service of TWINBASIC LLC offered to the user community.
diff --git a/docs/Features/index.md b/docs/Features/index.md
@@ -62,10 +62,14 @@ Modernized GUI components featuring:
 - 64-bit support and DPI awareness
 - New controls (QR Code, Multiframe, CheckMark)
 
-### [Packages](Packages/)
+### [Package Management](Packages/)
+
+twinBASIC[^1] has a centralized package repository, called TWINSERV. Users can publish both public and private packages. Package browsing, downloading, and publishing is seamlessly integrated into the IDE.
 
 Packages are collections of components that can be referenced from another twinBASIC project. They are distributed as TWINPACK files that contains everything needed by the components in that package.
 
+[^1]: A service of TWINBASIC LLC offered to the user community.
+
 ### [Advanced Features](Advanced/)
 
 Advanced programming capabilities:

diff --git a/docs/Miscellaneous/Documentation Development.md b/docs/Miscellaneous/Documentation Development.md
diff --git a/docs/Reference/Assert/index.md b/docs/Reference/Assert/index.md
@@ -1,7 +1,6 @@
 ---
 title: Assert Package
 parent: Packages
-grand_parent: Reference Section
 nav_order: 4
 permalink: /tB/Packages/Assert/
 has_toc: false

diff --git a/docs/Reference/CEF/index.md b/docs/Reference/CEF/index.md
@@ -1,7 +1,6 @@
 ---
 title: CEF Package
 parent: Packages
-grand_parent: Reference Section
 nav_order: 6
 permalink: /tB/Packages/CEF/
 has_toc: false

diff --git a/docs/Reference/CustomControls/index.md b/docs/Reference/CustomControls/index.md
@@ -1,7 +1,6 @@
 ---
 title: CustomControls Package
 parent: Packages
-grand_parent: Reference Section
 nav_order: 5
 permalink: /tB/Packages/CustomControls/
 has_toc: false

diff --git a/docs/Reference/Packages.md b/docs/Reference/Packages.md
@@ -1,7 +1,6 @@
 ---
 title: Packages
-parent: Reference Section
-nav_order: 20
+nav_order: 8
 permalink: /tB/Packages/
 has_toc: false
 ---

diff --git a/docs/Reference/VB/index.md b/docs/Reference/VB/index.md
@@ -1,7 +1,6 @@
 ---
 title: VB Package
 parent: Packages
-grand_parent: Reference Section
 nav_order: 1
 permalink: /tB/Packages/VB/
 has_toc: false

diff --git a/docs/Reference/VBA/Constants/VbAppWinStyle.md b/docs/Reference/VBA/Constants/VbAppWinStyle.md
@@ -1,6 +1,7 @@
 ---
 title: VbAppWinStyle
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbAppWinStyle
 redirect_from:
 - /tB/Core/VbAppWinStyle

diff --git a/docs/Reference/VBA/Constants/VbArchitecture.md b/docs/Reference/VBA/Constants/VbArchitecture.md
@@ -1,6 +1,7 @@
 ---
 title: VbArchitecture
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbArchitecture
 redirect_from:
 - /tB/Core/VbArchitecture

diff --git a/docs/Reference/VBA/Constants/VbCalendar.md b/docs/Reference/VBA/Constants/VbCalendar.md
@@ -1,6 +1,7 @@
 ---
 title: VbCalendar
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbCalendar
 redirect_from:
 - /tB/Core/VbCalendar

diff --git a/docs/Reference/VBA/Constants/VbCallType.md b/docs/Reference/VBA/Constants/VbCallType.md
@@ -1,6 +1,7 @@
 ---
 title: VbCallType
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbCallType
 redirect_from:
 - /tB/Core/VbCallType

diff --git a/docs/Reference/VBA/Constants/VbCompareMethod.md b/docs/Reference/VBA/Constants/VbCompareMethod.md
@@ -1,6 +1,7 @@
 ---
 title: VbCompareMethod
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbCompareMethod
 redirect_from:
 - /tB/Core/VbCompareMethod

diff --git a/docs/Reference/VBA/Constants/VbDateTimeFormat.md b/docs/Reference/VBA/Constants/VbDateTimeFormat.md
@@ -1,6 +1,7 @@
 ---
 title: VbDateTimeFormat
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbDateTimeFormat
 redirect_from:
 - /tB/Core/VbDateTimeFormat

diff --git a/docs/Reference/VBA/Constants/VbDayOfWeek.md b/docs/Reference/VBA/Constants/VbDayOfWeek.md
@@ -1,6 +1,7 @@
 ---
 title: VbDayOfWeek
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbDayOfWeek
 redirect_from:
 - /tB/Core/VbDayOfWeek

diff --git a/docs/Reference/VBA/Constants/VbFileAttribute.md b/docs/Reference/VBA/Constants/VbFileAttribute.md
@@ -1,6 +1,7 @@
 ---
 title: VbFileAttribute
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbFileAttribute
 redirect_from:
 - /tB/Core/VbFileAttribute

diff --git a/docs/Reference/VBA/Constants/VbFirstWeekOfYear.md b/docs/Reference/VBA/Constants/VbFirstWeekOfYear.md
@@ -1,6 +1,7 @@
 ---
 title: VbFirstWeekOfYear
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbFirstWeekOfYear
 redirect_from:
 - /tB/Core/VbFirstWeekOfYear

diff --git a/docs/Reference/VBA/Constants/VbIMEStatus.md b/docs/Reference/VBA/Constants/VbIMEStatus.md
@@ -1,6 +1,7 @@
 ---
 title: VbIMEStatus
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbIMEStatus
 redirect_from:
 - /tB/Core/VbIMEStatus

diff --git a/docs/Reference/VBA/Constants/VbMsgBoxResult.md b/docs/Reference/VBA/Constants/VbMsgBoxResult.md
@@ -1,6 +1,7 @@
 ---
 title: VbMsgBoxResult
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbMsgBoxResult
 redirect_from:
 - /tB/Core/VbMsgBoxResult

diff --git a/docs/Reference/VBA/Constants/VbMsgBoxStyle.md b/docs/Reference/VBA/Constants/VbMsgBoxStyle.md
@@ -1,6 +1,7 @@
 ---
 title: VbMsgBoxStyle
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbMsgBoxStyle
 redirect_from:
 - /tB/Core/VbMsgBoxStyle

diff --git a/docs/Reference/VBA/Constants/VbStrConv.md b/docs/Reference/VBA/Constants/VbStrConv.md
@@ -1,6 +1,7 @@
 ---
 title: VbStrConv
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbStrConv
 redirect_from:
 - /tB/Core/VbStrConv

diff --git a/docs/Reference/VBA/Constants/VbTriState.md b/docs/Reference/VBA/Constants/VbTriState.md
@@ -1,6 +1,7 @@
 ---
 title: VbTriState
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbTriState
 redirect_from:
 - /tB/Core/VbTriState

diff --git a/docs/Reference/VBA/Constants/VbVarType.md b/docs/Reference/VBA/Constants/VbVarType.md
@@ -1,6 +1,7 @@
 ---
 title: VbVarType
 parent: Constants Module
+grand_parent: VBA Package
 permalink: /tB/Modules/Constants/VbVarType
 redirect_from:
 - /tB/Core/VbVarType

diff --git a/docs/Reference/VBA/TbExpressionService/Bind.md b/docs/Reference/VBA/TbExpressionService/Bind.md
@@ -1,6 +1,6 @@
 ---
 title: Bind
-parent: TbExpressionService Module
+parent: TbExpressionService
 permalink: /tB/Modules/TbExpressionService/Bind
 redirect_from:
   - /tB/Modules/ExpressionService/Bind

diff --git a/docs/Reference/VBA/index.md b/docs/Reference/VBA/index.md
@@ -1,7 +1,6 @@
 ---
 title: VBA Package
 parent: Packages
-grand_parent: Reference Section
 nav_order: 2
 permalink: /tB/Packages/VBA
 redirect_from:

diff --git a/docs/Reference/VBRUN/AmbientProperties/BackColor.md b/docs/Reference/VBRUN/AmbientProperties/BackColor.md
@@ -1,6 +1,6 @@
 ---
 title: BackColor
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/BackColor
 ---
 # BackColor

diff --git a/docs/Reference/VBRUN/AmbientProperties/DisplayAsDefault.md b/docs/Reference/VBRUN/AmbientProperties/DisplayAsDefault.md
@@ -1,6 +1,6 @@
 ---
 title: DisplayAsDefault
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/DisplayAsDefault
 ---
 # DisplayAsDefault

diff --git a/docs/Reference/VBRUN/AmbientProperties/DisplayName.md b/docs/Reference/VBRUN/AmbientProperties/DisplayName.md
@@ -1,6 +1,6 @@
 ---
 title: DisplayName
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/DisplayName
 ---
 # DisplayName

diff --git a/docs/Reference/VBRUN/AmbientProperties/Font.md b/docs/Reference/VBRUN/AmbientProperties/Font.md
@@ -1,6 +1,6 @@
 ---
 title: Font
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/Font
 ---
 # Font

diff --git a/docs/Reference/VBRUN/AmbientProperties/ForeColor.md b/docs/Reference/VBRUN/AmbientProperties/ForeColor.md
@@ -1,6 +1,6 @@
 ---
 title: ForeColor
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/ForeColor
 ---
 # ForeColor

diff --git a/docs/Reference/VBRUN/AmbientProperties/LocaleID.md b/docs/Reference/VBRUN/AmbientProperties/LocaleID.md
@@ -1,6 +1,6 @@
 ---
 title: LocaleID
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/LocaleID
 ---
 # LocaleID

diff --git a/docs/Reference/VBRUN/AmbientProperties/MessageReflect.md b/docs/Reference/VBRUN/AmbientProperties/MessageReflect.md
@@ -1,6 +1,6 @@
 ---
 title: MessageReflect
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/MessageReflect
 ---
 # MessageReflect

diff --git a/docs/Reference/VBRUN/AmbientProperties/Palette.md b/docs/Reference/VBRUN/AmbientProperties/Palette.md
@@ -1,6 +1,6 @@
 ---
 title: Palette
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/Palette
 ---
 # Palette

diff --git a/docs/Reference/VBRUN/AmbientProperties/RightToLeft.md b/docs/Reference/VBRUN/AmbientProperties/RightToLeft.md
@@ -1,6 +1,6 @@
 ---
 title: RightToLeft
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/RightToLeft
 ---
 # RightToLeft

diff --git a/docs/Reference/VBRUN/AmbientProperties/ScaleUnits.md b/docs/Reference/VBRUN/AmbientProperties/ScaleUnits.md
@@ -1,6 +1,6 @@
 ---
 title: ScaleUnits
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/ScaleUnits
 ---
 # ScaleUnits

diff --git a/docs/Reference/VBRUN/AmbientProperties/ShowGrabHandles.md b/docs/Reference/VBRUN/AmbientProperties/ShowGrabHandles.md
@@ -1,6 +1,6 @@
 ---
 title: ShowGrabHandles
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/ShowGrabHandles
 ---
 # ShowGrabHandles

diff --git a/docs/Reference/VBRUN/AmbientProperties/ShowHatching.md b/docs/Reference/VBRUN/AmbientProperties/ShowHatching.md
@@ -1,6 +1,6 @@
 ---
 title: ShowHatching
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/ShowHatching
 ---
 # ShowHatching

diff --git a/docs/Reference/VBRUN/AmbientProperties/SupportsMnemonics.md b/docs/Reference/VBRUN/AmbientProperties/SupportsMnemonics.md
@@ -1,6 +1,6 @@
 ---
 title: SupportsMnemonics
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/SupportsMnemonics
 ---
 # SupportsMnemonics

diff --git a/docs/Reference/VBRUN/AmbientProperties/TextAlign.md b/docs/Reference/VBRUN/AmbientProperties/TextAlign.md
@@ -1,6 +1,6 @@
 ---
 title: TextAlign
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/TextAlign
 ---
 # TextAlign

diff --git a/docs/Reference/VBRUN/AmbientProperties/UIDead.md b/docs/Reference/VBRUN/AmbientProperties/UIDead.md
@@ -1,6 +1,6 @@
 ---
 title: UIDead
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/UIDead
 ---
 # UIDead

diff --git a/docs/Reference/VBRUN/AmbientProperties/UserMode.md b/docs/Reference/VBRUN/AmbientProperties/UserMode.md
@@ -1,6 +1,6 @@
 ---
 title: UserMode
-parent: AmbientProperties Module
+parent: AmbientProperties
 permalink: /tB/Packages/VBRUN/AmbientProperties/UserMode
 ---
 # UserMode