Skip to main content

Discuss Kit: Enhanced Documentation & Performance

wangshijun
ArcBlockDiscuss KitProduct Release

ArcBlock's newest release of Discuss Kit introduces a comprehensive suite of enhancements designed to elevate user experience, editor capabilities, and platform performance. This update features custom slug support for better URL management, substantial improvements to code block editing and image alignment, and the return of PWA support with optimized caching. Additionally, it addresses numerous bug fixes and performance optimizations, including a major upgrade to the technology stack with React 19, Vite 7, and MUI 7. Collectively, these improvements boost the platform’s reliability, usability, and performance for community builders and content creators.

Enhanced User Experience

1. Custom Slug Support for Discussions

This version brings custom slug support for discussion posts, empowering users to create descriptive, SEO-friendly URLs. Users can now define custom URL aliases that accurately reflect discussion content, making it easier to share, navigate, and improve search engine visibility.

Screenshot: feat(discussion): support custom slug

Improved Post Editing with Conflict Resolution

Post editing now features enhanced conflict handling, including force overwrite support. This streamlines collaboration when multiple users edit the same content, reducing frustration and improving teamwork.

Screenshot: feat: allow copying conflict content directly from conflict-alert

Auto-Translate Support for Posts

Auto-translate functionality is now available in the Post Component, enabling automatic content translation to bridge language barriers within global communities. This addition promotes inclusivity and engagement across diverse user groups.

Dedicated Search Page for ArcSphere

A newly introduced dedicated search page for ArcSphere offers users a streamlined, targeted search experience within the ArcSphere environment, enhancing content discovery and navigation.

Editor and Documentation Enhancements

Enhanced Code Block Experience

The code editing experience has been significantly improved with upgraded styling, advanced syntax highlighting, and a convenient one-click copy button. Code blocks now display line numbers and support dark mode, making it easier for developers to share and collaborate on code-centric content.

Screenshot: feat(editor): improve code block styling/highlighting & add copy button

Screenshot: feat(editor): improve code block styling/highlighting & add copy button

Enhanced Editor Functionality

The editor now features better styling and upgraded functionality. Combined with improved editor styles, these updates deliver a more intuitive and visually appealing content creation experience.

Document Full-Width Mode

Documentation pages now support a full-width mode, offering content creators a more immersive reading experience. This feature is ideal for presenting dense information without distractions.

Screenshot: feat(doc): support full-width mode & improve styling on doc page

Enhanced Documentation Components

The SubpageListing Component has been enhanced, and documentation tables are now more responsive. Together, these improvements make documentation easier to navigate and more accessible across a variety of devices.

Screenshot: feat(doc): support full-width mode & improve styling on doc page

Performance and Reliability Improvements

Re-enabled PWA Support with Optimized Caching

Progressive Web App (PWA) support has been restored with a more effective caching strategy. As a result, users enjoy faster load times and a smoother, app-like experience when accessing Discuss Kit via supported browsers.

Configurable Meilisearch Indexing

Users can now configure batch sizes for Meilisearch indexing, improving performance when handling large volumes of content. This flexibility ensures that search functionality remains responsive and efficient at any scale.

Major Technology Stack Upgrade

The platform’s core stack has been advanced to React 19, Vite 7, and MUI 7, with optimized bundle sizes for better performance. This upgrade enables access to the latest features and performance improvements from these frameworks.

Bug Fixes and Stability Improvements

Editor and Content Management

  • Fixed Safari back button issues on discussion pages with embedded iframes
  • Resolved image marker rendering issues and incorrect URL requests
  • Fixed image alignment functionality in the editor
  • Fixed markdown line break preservation
  • Enhanced Lottie animation loading with Suspense wrapper

User Experience and Interface

  • Prevented duplicate upload success handling for the same file
  • Fixed profile crashes caused by invalid date parsing
  • Improved pagination query parameter validation
  • Enhanced feedback entry functionality with context parameters
  • Cleaned up Meilisearch indexes before document collection creation to avoid duplicate data in query results.

System Reliability

  • Improved error handling for translation agent calls
  • Added proper error handling for AI Kit status checks
  • Enhanced conflict resolution in post editing with version tracking
  • Wrapped editor with Suspense to prevent content loss during re-renders

Performance Optimizations

  • Refactored chat functionality by removing react-flip-toolkit dependency
  • Removed StickyNode and EmojiPickerPlugin for better performance
  • Disabled EmojisPlugin to improve editor performance

What's Next

The Discuss Kit team remains dedicated to continuous improvement and innovation. Future updates will focus on further enhancing the editing experience, expanding integration capabilities, and implementing additional performance optimizations. User feedback will continue to shape new features and improvements.

Resources

For more information on Discuss Kit and its features, check out the following resources:

This release represents a significant step forward in making Discuss Kit more robust, user-friendly, and performant, providing community builders with the tools they need to create engaging and accessible online communities.

Referenced here

Products

  • DiscussKit improving

    An application for documentation, discussions and feeds. DiscussKit is being improved as a standalone product; some of its capabilities are also part of ARC.