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

Create 'Tickets' Knowledge Base section in Portal (Mirror GitHub Issues)

Closed v11.23.0 documentationenhancementepicai
tobiu
tobiu commented on Jan 7, 2026, 10:26 PM

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.
tobiu added the documentation label on Jan 7, 2026, 10:26 PM
tobiu added the enhancement label on Jan 7, 2026, 10:26 PM
tobiu added the epic label on Jan 7, 2026, 10:26 PM
tobiu added the ai label on Jan 7, 2026, 10:26 PM
tobiu assigned to @tobiu on Jan 7, 2026, 10:27 PM
tobiu cross-referenced by #8501 on Jan 10, 2026, 3:27 PM
tobiu added sub-issue #8501 on Jan 10, 2026, 3:28 PM
tobiu
tobiu Jan 10, 2026, 3:32 PM

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.

tobiu added sub-issue #8502 on Jan 10, 2026, 3:41 PM
tobiu added sub-issue #8503 on Jan 10, 2026, 3:54 PM
tobiu added sub-issue #8504 on Jan 10, 2026, 4:00 PM
tobiu cross-referenced by #8505 on Jan 10, 2026, 4:32 PM
tobiu added sub-issue #8505 on Jan 10, 2026, 4:32 PM
tobiu cross-referenced by #8506 on Jan 10, 2026, 4:37 PM
tobiu added sub-issue #8506 on Jan 10, 2026, 4:38 PM
tobiu cross-referenced by #8509 on Jan 10, 2026, 5:59 PM
tobiu added sub-issue #8509 on Jan 10, 2026, 5:59 PM
tobiu added sub-issue #8511 on Jan 10, 2026, 6:43 PM
tobiu cross-referenced by #8514 on Jan 10, 2026, 7:27 PM
tobiu added sub-issue #8520 on Jan 10, 2026, 9:00 PM
tobiu added sub-issue #8521 on Jan 10, 2026, 9:05 PM
tobiu added sub-issue #8522 on Jan 10, 2026, 9:09 PM
tobiu added sub-issue #8523 on Jan 10, 2026, 9:18 PM
tobiu referenced in commit 1208fa3 - "feat: Support internal routing for Markdown ticket links (#8398) on Jan 10, 2026, 10:02 PM
tobiu added sub-issue #8524 on Jan 10, 2026, 10:18 PM
tobiu added sub-issue #8525 on Jan 10, 2026, 10:40 PM
tobiu added sub-issue #8526 on Jan 10, 2026, 10:48 PM
tobiu added sub-issue #8529 on Jan 11, 2026, 12:07 AM
tobiu added sub-issue #8530 on Jan 11, 2026, 12:19 AM
tobiu added sub-issue #8531 on Jan 11, 2026, 1:07 AM
tobiu added sub-issue #8533 on Jan 11, 2026, 1:55 AM
tobiu added sub-issue #8534 on Jan 11, 2026, 2:13 AM
tobiu cross-referenced by #8537 on Jan 11, 2026, 11:16 AM
tobiu added sub-issue #8536 on Jan 11, 2026, 2:25 PM
tobiu added sub-issue #8542 on Jan 11, 2026, 2:25 PM
tobiu added sub-issue #8546 on Jan 11, 2026, 3:29 PM
tobiu added sub-issue #8544 on Jan 11, 2026, 3:30 PM
tobiu added sub-issue #8543 on Jan 11, 2026, 3:30 PM
tobiu added sub-issue #8547 on Jan 11, 2026, 4:10 PM
tobiu added sub-issue #8548 on Jan 11, 2026, 4:21 PM
tobiu added sub-issue #8549 on Jan 11, 2026, 4:32 PM
tobiu referenced in commit fea49de - "refactor: Decouple TicketTimelineSection from generic ContentSection (#8398) on Jan 11, 2026, 4:58 PM
tobiu referenced in commit 8e74309 - "fix: Prevent selection of undefined records in Tickets view (#8398) on Jan 11, 2026, 5:21 PM
tobiu added sub-issue #8551 on Jan 11, 2026, 5:52 PM
tobiu added sub-issue #8552 on Jan 11, 2026, 5:57 PM
tobiu added sub-issue #8553 on Jan 11, 2026, 6:01 PM
tobiu added sub-issue #8554 on Jan 11, 2026, 6:04 PM
tobiu added sub-issue #8555 on Jan 11, 2026, 6:22 PM
tobiu added sub-issue #8556 on Jan 11, 2026, 6:44 PM
tobiu added sub-issue #8557 on Jan 11, 2026, 6:51 PM