From 40e5f3db02cc8dcde2224022bfa1ece70298c5b8 Mon Sep 17 00:00:00 2001 From: Zack Katz Date: Tue, 27 Jan 2026 19:49:35 -0500 Subject: [PATCH 01/11] fix: Remove pagination nav from product landing pages Add pagination_prev: null and pagination_next: null to the product index template to remove the next/previous footer navigation. --- templates/hooks/product-index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/templates/hooks/product-index.md b/templates/hooks/product-index.md index 2b47c1b..5a9a8a4 100644 --- a/templates/hooks/product-index.md +++ b/templates/hooks/product-index.md @@ -3,6 +3,8 @@ sidebar_position: 1 sidebar_label: "{{label}}" title: {{label}} Developer Documentation description: Developer documentation for {{label}} including hooks, actions, filters, and PHP API reference +pagination_prev: null +pagination_next: null --- # {{label}} From af45a4016fc4fa6e1cde0b57f6cd98d5e777e9ad Mon Sep 17 00:00:00 2001 From: Zack Katz Date: Tue, 27 Jan 2026 19:50:25 -0500 Subject: [PATCH 02/11] fix: Disable pagination on all index templates --- templates/hooks/actions-index.md | 2 ++ templates/hooks/filters-index.md | 2 ++ templates/hooks/main-index.md | 2 ++ 3 files changed, 6 insertions(+) diff --git a/templates/hooks/actions-index.md b/templates/hooks/actions-index.md index 46aedde..88f8554 100644 --- a/templates/hooks/actions-index.md +++ b/templates/hooks/actions-index.md @@ -2,6 +2,8 @@ sidebar_position: 1 title: Actions description: Action hooks available in {{label}} +pagination_prev: null +pagination_next: null --- # {{label}} Actions diff --git a/templates/hooks/filters-index.md b/templates/hooks/filters-index.md index 0eb7cce..323f025 100644 --- a/templates/hooks/filters-index.md +++ b/templates/hooks/filters-index.md @@ -2,6 +2,8 @@ sidebar_position: 2 title: Filters description: Filter hooks available in {{label}} +pagination_prev: null +pagination_next: null --- # {{label}} Filters diff --git a/templates/hooks/main-index.md b/templates/hooks/main-index.md index 493bcbb..c5f00e7 100644 --- a/templates/hooks/main-index.md +++ b/templates/hooks/main-index.md @@ -2,6 +2,8 @@ sidebar_position: 1 title: GravityKit Hooks Reference description: Complete reference for WordPress hooks in GravityKit products +pagination_prev: null +pagination_next: null --- # GravityKit Hooks Reference From 7204d73dbf3784ee57502b4826cac3fa9ba0feff Mon Sep 17 00:00:00 2001 From: Zack Katz Date: Tue, 27 Jan 2026 21:24:26 -0500 Subject: [PATCH 03/11] fix: Sync methods table with Method Reference section Both now use the same hasMeaningfulDoc filter, ensuring methods in the table always have corresponding entries in the Method Reference section below. --- scripts/generate-php-api.mjs | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/scripts/generate-php-api.mjs b/scripts/generate-php-api.mjs index 7362f35..e0329fb 100644 --- a/scripts/generate-php-api.mjs +++ b/scripts/generate-php-api.mjs @@ -1468,8 +1468,9 @@ function generateClassPage({ productLabel, classSymbol, product, repoRef, typeLi : ''; const methods = classSymbol.methods ?? []; - const methodTableRows = methods.length - ? methods + const documentedMethods = methods.filter((m) => hasMeaningfulDoc(m)); + const methodTableRows = documentedMethods.length + ? documentedMethods .map( (m) => `| [\`${m.name}()\`](#${m.name.toLowerCase()}) | ${mdEscape(m.summary || '')} |` @@ -1477,8 +1478,7 @@ function generateClassPage({ productLabel, classSymbol, product, repoRef, typeLi .join('\n') : ''; - const methodSections = methods - .filter((m) => hasMeaningfulDoc(m)) + const methodSections = documentedMethods .map((m) => { const sourceLine = formatSourceMarkdown({ product, repoRef, file: m.file || classSymbol.file, line: m.line }); const since = (m.tags?.since ?? []).map(parseSinceTagValue).filter(Boolean); @@ -1558,7 +1558,7 @@ ${propertyTableRows} ` : ''} ## Methods -${methods.length ? `| Method | Description | +${documentedMethods.length ? `| Method | Description | | --- | --- | ${methodTableRows} ` : '_No documented public methods found._'} From a118433436a432767b819eeaa3be9a944a13bab1 Mon Sep 17 00:00:00 2001 From: Zack Katz Date: Tue, 27 Jan 2026 21:38:06 -0500 Subject: [PATCH 04/11] fix: Escape HTML in API docs summaries and descriptions HTML tags in PHPDoc descriptions (like