---
id: 8398
title: Create 'Tickets' Knowledge Base section in Portal (Mirror GitHub Issues)
state: CLOSED
labels:
  - documentation
  - enhancement
  - epic
  - ai
assignees:
  - tobiu
createdAt: '2026-01-07T21:26:28Z'
updatedAt: '2026-01-17T23:00:38Z'
githubUrl: 'https://github.com/neomjs/neo/issues/8398'
author: tobiu
commentsCount: 2
parentIssue: null
subIssues:
  - '[x] 8501 Implement Ticket Index Generation Script'
  - '[x] 8502 Refine Ticket Index Structure for TreeList'
  - '[x] 8503 Create Portal.model.Ticket'
  - '[x] 8504 Create Portal.store.Tickets'
  - '[x] 8505 Implement Tickets View Structure (Scaffolding)'
  - '[x] 8506 Add Tickets Tab to Portal News Section'
  - '[x] 8509 Optimization: Minify Indices and Prune Release Model'
  - '[x] 8511 Enhance Ticket Markdown Rendering with Badges'
  - '[x] 8520 Enhance Markdown Frontmatter Animation'
  - '[x] 8521 Animate Frontmatter Toggle Icon (Rotate Plus to X)'
  - '[x] 8522 Use Badge Style for Labels in Ticket Frontmatter'
  - '[x] 8523 Implement Ticket Status Badges (Open/Closed)'
  - '[x] 8524 Enhance TreeList navigation for internal routing and deep linking'
  - '[x] 8525 Add Release badge to Ticket Header for navigation'
  - '[x] 8526 Fix CSS collision for state badge icons in Tickets view'
  - '[x] 8529 Implement rich HTML Timeline rendering for Ticket view'
  - '[x] 8530 Integrate Ticket Body into Timeline view'
  - '[x] 8531 Polish Portal Ticket Timeline: Author & Commit Links'
  - '[x] 8533 Portal Ticket Timeline: Localized & Smart Timestamp Formatting'
  - '[x] 8534 Portal Ticket Timeline: Render Labels as Badges'
  - '[x] 8536 Feature: Canvas-based "Neural" Timeline Animation'
  - '[x] 8542 Enhancement: "Orbit" Effect & Visual Polish for Neural Timeline'
  - '[x] 8546 Fix TimelineCanvas crash on ticket switch (records.map is not a function)'
  - '[x] 8544 Enhancement: Physics-based "Traffic" Animation (Variable Speed & Length)'
  - '[x] 8543 Enhancement: "Orbit" Animation Logic (Pulse travels around nodes)'
  - '[x] 8547 fix: Portal App tree navigation scrolling behavior'
  - '[x] 8548 Refactor PageContainer for Tickets View'
  - '[x] 8549 Fix duplicate listener on TimelineCanvas during navigation'
  - '[x] 8551 Refactor TicketCanvas: Performance optimization and cleanup'
  - '[x] 8552 Enhance TicketCanvas Documentation for Knowledge Base'
  - '[x] 8553 Enhance TimelineCanvas Documentation for Knowledge Base'
  - '[x] 8554 Enhance TicketComponent Documentation for Knowledge Base'
  - '[x] 8555 Fix Zombie Canvas Loop in TicketCanvas'
  - '[x] 8556 Enhance Neural Timeline: Limit spine and pulse to last item'
  - '[x] 8557 Fix Ticket Timeline content overflow'
  - '[x] 8559 Optimize TimelineCanvas data load delay'
  - '[x] 8560 Replace hardcoded timeout in MainContainerController with deterministic wait'
  - '[x] 8561 Remove arbitrary delay in TreeList afterSetCurrentPageRecord'
  - '[x] 8562 Refactor TimelineCanvas.onTimelineDataLoad to use waitForDomRect'
  - '[x] 8563 Prevent race condition in TimelineCanvas by making sections store update optional'
  - '[x] 8564 Reset TicketCanvas animation on data load'
  - '[x] 8565 Scope timeline item IDs to Ticket ID to prevent stale rects on switch'
subIssuesCompleted: 42
subIssuesTotal: 42
blockedBy: []
blocking: []
closedAt: '2026-01-17T23:00:38Z'
---
# Create 'Tickets' Knowledge Base section in Portal (Mirror GitHub Issues)

**Goal:** Transform the Portal into a comprehensive "Knowledge Hub" by mirroring selected GitHub tickets as indexable content. This strategy aims to capture long-tail SEO traffic (specific error messages/solutions), provide structured training data for AI, and demonstrate project velocity.

**Strategic Value:** "Own Your Knowledge". By hosting ticket content on `neomjs.com`, we create a coherent internal knowledge graph (Release Notes -> Ticket -> Docs) that is superior to disparate GitHub pages for both Googlebot and LLMs.

**Key Objectives:**

1.  **Data Pipeline (`buildScripts/createTicketIndex.mjs`):**
    *   Parse `.github/ISSUE_ARCHIVE/` to generate a `tickets.json` index.
    *   **Crucial Filter:** Exclude noise. Only index tickets with high-value labels (e.g., `bug`, `feature`, `enhancement`, `documentation`). Exclude `chore`, `task`, `agent-task`.
    *   Structure the index for efficient loading (potentially paginated or grouped by Year/Milestone).

2.  **UI Implementation:**
    *   Add a "Tickets" tab to the `NewsTabContainer` in the Portal.
    *   Reuse the `apps/portal/view/shared/content/` architecture (TreeList + Markdown View) to display the tickets.
    *   **Read-Only Design:** Clearly position this as an archive/knowledge base. Include a prominent "View Discussion on GitHub" link for interaction.

3.  **Content Rendering:**
    *   Leverage recent `Neo.component.Markdown` enhancements (implicit readonly code blocks, automatic ticket linking) to render ticket bodies faithfully.
    *   Ensure ticket references (e.g., `#123`) within these pages link to the *internal* portal ticket page, keeping the user on-domain.

4.  **Integration:**
    *   Add the new section to the Sitemap and `llms.txt` generation scripts.
    *   Update Release Notes generation to optionally prefer internal ticket links over external GitHub links.

## Timeline

- 2026-01-07T21:26:29Z @tobiu added the `documentation` label
- 2026-01-07T21:26:30Z @tobiu added the `enhancement` label
- 2026-01-07T21:26:30Z @tobiu added the `epic` label
- 2026-01-07T21:26:30Z @tobiu added the `ai` label
- 2026-01-07T21:27:40Z @tobiu assigned to @tobiu
- 2026-01-10T14:27:58Z @tobiu cross-referenced by #8501
- 2026-01-10T14:28:10Z @tobiu added sub-issue #8501
### @tobiu - 2026-01-10T14:32:26Z

**Input from Gemini 3 Pro:**

> ✦ I have implemented the ticket index generator. See #8501 for details.
> We now have `apps/portal/resources/data/tickets.json` available for the UI implementation phase.
> 

- 2026-01-10T14:41:22Z @tobiu added sub-issue #8502
- 2026-01-10T14:54:39Z @tobiu added sub-issue #8503
- 2026-01-10T15:00:26Z @tobiu added sub-issue #8504
- 2026-01-10T15:32:33Z @tobiu cross-referenced by #8505
- 2026-01-10T15:32:44Z @tobiu added sub-issue #8505
- 2026-01-10T15:37:45Z @tobiu cross-referenced by #8506
- 2026-01-10T15:38:11Z @tobiu added sub-issue #8506
- 2026-01-10T16:59:26Z @tobiu cross-referenced by #8509
- 2026-01-10T16:59:34Z @tobiu added sub-issue #8509
- 2026-01-10T17:43:12Z @tobiu added sub-issue #8511
- 2026-01-10T18:27:46Z @tobiu cross-referenced by #8514
- 2026-01-10T20:00:12Z @tobiu added sub-issue #8520
- 2026-01-10T20:05:07Z @tobiu added sub-issue #8521
- 2026-01-10T20:09:40Z @tobiu added sub-issue #8522
- 2026-01-10T20:18:21Z @tobiu added sub-issue #8523
- 2026-01-10T21:02:06Z @tobiu referenced in commit `1208fa3` - "feat: Support internal routing for Markdown ticket links (#8398)

Updates Markdown component to respect local routing for ticket IDs if the configured issuesUrl starts with #."
- 2026-01-10T21:18:10Z @tobiu added sub-issue #8524
- 2026-01-10T21:40:11Z @tobiu added sub-issue #8525
- 2026-01-10T21:48:30Z @tobiu added sub-issue #8526
- 2026-01-10T23:07:39Z @tobiu added sub-issue #8529
- 2026-01-10T23:19:01Z @tobiu added sub-issue #8530
- 2026-01-11T00:07:16Z @tobiu added sub-issue #8531
- 2026-01-11T00:55:28Z @tobiu added sub-issue #8533
- 2026-01-11T01:13:04Z @tobiu added sub-issue #8534
- 2026-01-11T10:16:53Z @tobiu cross-referenced by #8537
- 2026-01-11T13:25:00Z @tobiu added sub-issue #8536
- 2026-01-11T13:25:31Z @tobiu added sub-issue #8542
- 2026-01-11T14:29:19Z @tobiu added sub-issue #8546
- 2026-01-11T14:30:27Z @tobiu added sub-issue #8544
- 2026-01-11T14:30:50Z @tobiu added sub-issue #8543
- 2026-01-11T15:10:24Z @tobiu added sub-issue #8547
- 2026-01-11T15:21:46Z @tobiu added sub-issue #8548
- 2026-01-11T15:32:14Z @tobiu added sub-issue #8549
- 2026-01-11T15:58:35Z @tobiu referenced in commit `fea49de` - "refactor: Decouple TicketTimelineSection from generic ContentSection (#8398)

- Reverts  model to its generic state (id, name, tag).
- Creates  model with full field set (including inherited fields).
- Creates  store extending the base store.
- Updates  to use the new specialized store."
- 2026-01-11T16:21:07Z @tobiu referenced in commit `8e74309` - "fix: Prevent selection of undefined records in Tickets view (#8398)

Fixes a runtime TypeError when  attempts to select a record that does not exist in the store."
- 2026-01-11T16:52:24Z @tobiu added sub-issue #8551
- 2026-01-11T16:57:53Z @tobiu added sub-issue #8552
- 2026-01-11T17:01:44Z @tobiu added sub-issue #8553
- 2026-01-11T17:04:38Z @tobiu added sub-issue #8554
- 2026-01-11T17:22:23Z @tobiu added sub-issue #8555
- 2026-01-11T17:44:26Z @tobiu added sub-issue #8556
- 2026-01-11T17:51:31Z @tobiu added sub-issue #8557

