📖 2 min read

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]#

Added#

  • Release Notes tab in top-level navigation

  • Semi-automated changelog draft script (scripts/draft-changelog.sh)

  • Mermaid diagram rendering via sphinxcontrib-mermaid

  • Star-border effect on all homepage cards

  • Announcement banner promoting Release Notes

  • markdownlint config (.markdownlint-cli2.yaml)

Changed#

  • Simplified homepage: removed Learning Path section and redundant h1

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

Removed#

  • sphinx-tippy tooltips (inconsistent and unhelpful)

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

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

[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