Repo sync

.github/workflows/test.yml

@@ -166,4 +166,5 @@ jobs:
           # Enable debug logging when "Re-run jobs with debug logging" is used in GitHub Actions UI
           # This will output additional timing and path information to help diagnose timeout issues
           RUNNER_DEBUG: ${{ runner.debug }}
-        run: npm test -- src/${{ matrix.name }}/tests/
+          VITEST_FLAGS: ${{ matrix.name == 'article-api' && '--no-file-parallelism --maxWorkers=1' || '' }}
+        run: npm test -- $VITEST_FLAGS src/${{ matrix.name }}/tests/

content/code-security/tutorials/secret-scanning-partner-program.md

@@ -109,6 +109,7 @@ The list of valid values for `source` are:
 * Wiki_content
 * Wiki_commit
 * Npm
+* Manual_submission
 * Unknown
 
 ### Implement signature verification in your secret alert service

src/app/lib/main-context-adapter.ts

@@ -40,6 +40,7 @@ export function adaptAppRouterContextToMainContext(
       oldestSupported: '',
       nextDeprecationDate: '',
       supported: [],
+      releasesWithOldestDeprecationDate: [],
     },
     enterpriseServerVersions: [],
     error: '',

src/article-api/README.md

@@ -23,12 +23,9 @@ The `/api/article` endpoints return information about a page by `pathname`.
 
 ### Autogenerated Content Transformers
 
-For autogenerated pages (REST, GraphQL, webhooks, landing pages, audit logs, etc), the Article API uses specialized transformers to convert the rendered content into markdown format. These transformers are located in `src/article-api/transformers/` and use an extensible architecture:
+For autogenerated pages (REST, GraphQL, webhooks, landing pages, audit logs, etc), the Article API uses specialized transformers to convert the rendered content into markdown format. These transformers are located in `src/article-api/transformers/` and use an extensible architecture.
 
-#### Current Transformers
-
-- **REST Transformer** (`rest-transformer.ts`) - Converts REST API operations into markdown, including endpoints, parameters, status codes, and code examples
-- **GraphQL Transformer** (`graphql-transformer.ts`) - Converts GraphQL schema documentation into markdown, including queries, mutations, objects, interfaces, enums, unions, input objects, scalars, changelog, and breaking changes
+#### Transformers
 
 To add a new transformer for other autogenerated content types:
 1. Create a new transformer file implementing the `PageTransformer` interface
@@ -195,15 +192,7 @@ npm run test -- src/article-api/tests
 
 - Team: Docs Engineering
 
-## Transformers
-
-Currently implemented transformers:
-- **REST API transformer** (`rest-transformer.ts`) - Converts REST API autogenerated content
-- **GraphQL transformer** (`graphql-transformer.ts`) - Converts GraphQL API autogenerated content
-- **Audit logs transformer** (`audit-logs-transformer.ts`) - Converts audit log tables to markdown
-
 ### Known limitations
-- Some autogenerated content types don't have transformers yet
 - Cache invalidation is manual
-- No built-in rate limiting
+- No built-in rate limiting (uses Fastly instead)
 - Limited API versioning

src/fixtures/fixtures/index.md

@@ -0,0 +1,6 @@
+---
+title: This is an index page
+intro: 'I am missing a children frontmatter property'
+versions:
+  fpt: '*'
+---

src/fixtures/fixtures/sample-toc-index.md

@@ -2,6 +2,6 @@
 title: A sample TOC
 versions:
   free-pro-team: '*'
+children:
+  - /article-one
 ---
-
-{% link_in_list /sample-article %}

src/frame/components/context/MainContext.tsx

@@ -86,6 +86,7 @@ type EnterpriseServerReleases = {
   oldestSupported: string
   nextDeprecationDate: string
   supported: Array<string>
+  releasesWithOldestDeprecationDate: Array<string>
 }
 
 export type MainContextT = {
@@ -193,7 +194,11 @@ export const getMainContext = async (req: any, res: any): Promise<MainContextT>
 
   // To know whether we need this key, we need to match this
   // with the business logic in `DeprecationBanner.tsx` which is as follows:
-  if (req.context.currentVersion.includes(req.context.enterpriseServerReleases.oldestSupported)) {
+  if (
+    req.context.enterpriseServerReleases.releasesWithOldestDeprecationDate.includes(
+      req.context.currentRelease,
+    )
+  ) {
     reusables.enterprise_deprecation = {
       version_was_deprecated: req.context.getDottedData(
         'reusables.enterprise_deprecation.version_was_deprecated',
@@ -264,6 +269,7 @@ export const getMainContext = async (req: any, res: any): Promise<MainContextT>
       'oldestSupported',
       'nextDeprecationDate',
       'supported',
+      'releasesWithOldestDeprecationDate',
     ]),
     enterpriseServerVersions: req.context.enterpriseServerVersions,
     error: req.context.error ? req.context.error.toString() : '',

src/frame/lib/page.ts

@@ -6,7 +6,6 @@ import getApplicableVersions from '@/versions/lib/get-applicable-versions'
 import generateRedirectsForPermalinks from '@/redirects/lib/permalinks'
 import getEnglishHeadings from '@/languages/lib/get-english-headings'
 import { getAlertTitles } from '@/languages/lib/get-alert-titles'
-import getTocItems from './get-toc-items'
 import Permalink from './permalink'
 import { renderContent } from '@/content-render/index'
 import processLearningTracks from '@/learning-track/lib/process-learning-tracks'
@@ -100,6 +99,8 @@ class Page {
   public rawRecommended?: string[]
   public autogenerated?: string
   public featuredLinks?: FeaturedLinksExpanded
+  public children?: string[]
+  public layout?: string
 
   // Derived properties
   public languageCode!: string
@@ -111,7 +112,6 @@ class Page {
   public documentType: string
   public applicableVersions: string[]
   public permalinks: Permalink[]
-  public tocItems?: any[]
   public communityRedirect?: CommunityRedirect
   public detectedPlatforms: string[] = []
   public includesPlatformSpecificContent: boolean = false
@@ -259,9 +259,13 @@ class Page {
       this.applicableVersions,
     )
 
+    // Ensure 'children' frontmatter exists if this is a standard index page
     if (this.relativePath.endsWith('index.md')) {
-      // get an array of linked items in product and category TOCs
-      this.tocItems = getTocItems(this)
+      if (!this.children && !/(search|early-access)\/.*index.md/.test(this.relativePath)) {
+        if (this.layout !== 'journey-landing') {
+          throw new Error(`${this.fullPath} must contain 'children' frontmatter.`)
+        }
+      }
     }
 
     // if this is an article and it doesn't have showMiniToc = false, set mini TOC to true

src/frame/middleware/context/generic-toc.ts

@@ -131,7 +131,7 @@ async function getTocItems(node: Tree, context: Context, opts: Options): Promise
   }
 
   return await Promise.all(
-    node.childPages.filter(filterHidden).map(async (child) => {
+    (node.childPages || []).filter(filterHidden).map(async (child) => {
       const { page } = child
       const title = await page.renderProp('rawTitle', context, { textOnly: true })
       const octicon = page.octicon ?? null