Platform Changelog#

All notable changes to the site platform (features, fixes, infrastructure) are documented here. This project adheres to Semantic Versioning and is inspired by Keep a Changelog.

[Unreleased]#

[2.2.0] - 2026-04-15#

Added#

  • LICENSE (proprietary FPT internal), CHANGELOG.md (redirect to release notes), CONTRIBUTING.md (comprehensive KT guide)

  • Wiki documentation (wiki/) with 9 pages: architecture, content guide, extensions, infrastructure, dependencies, style guide, onboarding, project management

  • CI job sync-wiki to auto-sync wiki/ to GitLab Wiki repo on push to main

  • Issue templates: bug, content-request, feature-request, chore (with quick-action labels)

  • Default MR template with pre-merge checklist

  • 15 scoped labels: type::, status::, priority:: at group fhn-ngt; domain:: at subgroup fhn-ngt/intern

  • Kanban issue board with 5 columns: Open → Backlog → In Progress → Review → Closed

  • MR preview environment via Cloudflare Pages (deploy-preview CI job, auto-stop after 1 week)

  • Ruff linter and formatter for custom Sphinx extensions (src/_ext/)

  • GitLab Project Setup Playbook in CLAUDE.md (reusable for other repos)

Changed#

  • README: fixed project structure (was learning/, training/ — now ai/, software-engineering/, cloud-and-infrastructure/), updated Python version to 3.14, replaced make commands with task, replaced docs/ references with wiki/

  • CI pipeline: added post-deploy stage for wiki sync

Fixed#

  • Removed unused variable anchorname in sidebar_nav.py (flagged by ruff)

[2.1.0] - 2026-04-03#

Added#

  • NGC-style sidebar navigation with Material Icons, 4-level depth, and flyout menus

  • Sidebar organized into sections: Table of Contents, Common Resources, Get Involved

  • Accordion behavior: only one nav item expanded per level

  • Sidebar collapse toggle: icon-only mode with tooltips

  • Terminal-style 404 page with monospace font

  • BU (NGT) logo in navbar with vertical divider, FPT-only footer

  • Tech joke terminal on homepage fetching from JokeAPI

  • Dark variant of NGT logo for light mode

  • Release Notes tab in top-level navigation

  • Mermaid diagram rendering via sphinxcontrib-mermaid

  • Star-border effect on all homepage cards

  • markdownlint config (.markdownlint-cli2.yaml)

  • Commitlint config enforcing conventional commits

  • Manual changelog process replacing auto-generated changelogs

  • CI: split pipeline into separate sphinx-build and cloudflare-deploy jobs

  • CI: Docker image for build environment (Python, uv, Node.js, wrangler)

  • CI: Cloudflare cache purge after deploy

  • CI: CDN-Cache-Control headers for custom domain sync

Changed#

  • Color palette from NVIDIA green to FPT orange (#fb923c dark / #ea580c light)

  • Sidebar navigation renamed: Learn → Learning, Reference → References

  • Homepage: replaced 4 navigation cards with terminal joke widget

  • Hero section: reduced height, removed aurora gradient overlay

  • Project moved from fhn-ngt/audit-intern-resources to fhn-ngt/intern/audit-intern-resources

  • Updated all GitLab URLs to new project path

  • Simplified homepage: removed Learning Path section and redundant h1

  • Consolidated markdownlint config into single .markdownlint-cli2.yaml

  • Site URL consolidated to ai-roadmap.ops-ai.dev

Fixed#

  • Scrollable sidebar with fixed flyout positioning and hover delay

  • Edge-to-edge layout: sidebar and navbar flush left

  • Vale vocabulary tracking and uv sync in CI

  • Link-check job set to fail on broken links

Removed#

  • Announcement banner

  • Reading time indicators from all pages

  • Page metadata (authors, module labels) from article headers

  • Per-file last-updated timestamps (replaced with repo-wide date)

  • sphinx-tippy tooltips (inconsistent and unhelpful)

  • sphinx-reredirects and 60+ URL redirects (clean break)

  • Legacy fresher-training-program/ directory (49 files)

  • Auto-generated changelog scripts

[2.0.0] - 2026-03-22#

Added#

  • Information Architecture restructure: Learn, Training, Reference, and Resources sections

  • 60+ URL redirects via sphinx-reredirects for backward compatibility

  • ReactBits visual effects (aurora, particles, tilt, spotlight, star-border, click-spark)

  • Custom Sphinx extensions: reading_time, course_metadata, course_index

  • Homepage redesign with hero section, learning path visualization, and course grid

  • Per-page “last updated” timestamp from git history (Vietnam timezone)

  • Page metadata and prev-next position templates

  • Monochrome FPT logo in footer

  • Vale prose linter with AI-specific vocabulary

  • Commitlint enforcement (no body/footer)

Changed#

  • Overhauled CSS to NVIDIA-style design system

  • Replaced custom effects.js with ported ReactBits CSS/JS modules

  • Renamed “courses” to “fresher-training-program”

  • Restructured all file paths to clean kebab-case URLs

Fixed#

  • Resolved 2195+ Sphinx build warnings

  • Fixed 284 markdown linting warnings

  • Replaced broken external links and bot-blocked URLs

  • Override NVIDIA theme logo with FPT logo via Sphinx hook

[1.1.0] - 2026-03-20#

Added#

  • Migration from Docusaurus to Sphinx with NVIDIA theme

  • Python project config (pyproject.toml), static assets, and favicon

  • Markdownlint config across 329 files

  • FPT branding (navbar logo, footer logo)

Changed#

  • Migrated Sphinx source root from . to src/

  • CI pipeline: merged build and deploy into single job to avoid artifact size limit

Removed#

  • Docusaurus framework, config, and all related artifacts

  • Legacy _redirects file and unused Docusaurus plugins

[1.0.0] - 2026-02-03#

Added#

  • GitLab CI/CD pipeline with Cloudflare Pages deployment via Wrangler

  • Pre-commit hooks with linting stage in CI

  • R2 cache via rclone for build optimization

  • Unit test framework with coverage reporting

Changed#

  • Migrated CI from GitHub Actions to GitLab CI (Bun, then Node.js)

  • Streamlined Wrangler deployment with environment auto-triggers

Removed#

  • GitHub Actions workflows

  • Typos spell-check job (replaced by pre-commit)

[0.1.0] - 2026-01-07#

Added#

  • Initial Docusaurus site with FPT color template

  • GitHub Actions CI for build and deploy

  • Sidebar navigation with collapsible sections

  • Blog-style content structure