Skip to content

Commit ffec3f4

Browse files
mintlify[bot]mintlify[bot]
authored
Update changelog.mdx
1 parent 7c420a0 commit ffec3f4

File tree

1 file changed

+142
-0
lines changed

1 file changed

+142
-0
lines changed

‎changelog.mdx‎

Lines changed: 142 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,148 @@ rss: true
55
noindex: true
66
---
77

8+
<Update label="November 21" tags={["New releases", "Improvements"]} rss={{ title: "Weekly Updates", description: "Standard Markdown support, custom syntax highlighting, API playground enhancements, and web editor improvements" }}>
9+
## New features
10+
11+
- **Standard Markdown file support**: You can now use standard `.md` files in addition to `.mdx` files in your documentation, making it easier to migrate existing Markdown content without conversion
12+
- **Custom syntax highlighting**: Add support for custom programming languages in code blocks through the `styling.codeblocks.customLanguages` field in `docs.json`, enabling syntax highlighting for domain-specific languages with custom Shiki grammars
13+
- **PowerShell and Swift code examples**: API playground now generates code examples in PowerShell and Swift, expanding language support for API testing and integration
14+
- **View component**: New `<View>` component for conditional rendering based on screen size or other display properties
15+
16+
## API playground improvements
17+
18+
- Fixed issue where switching between response examples with different indices would fail to render the response section
19+
- Resolved double Authorization header bug that was causing authentication issues in API requests
20+
- Fixed oneOf schema rendering issues that were causing incorrect field displays in complex API schemas
21+
- Improved response example generation to properly merge and display all required properties
22+
- Fixed missing path parameters on certain API documentation pages
23+
- Fixed extra separator appearing in array item schemas with no contents
24+
- Fixed missing prefill examples in object arrays
25+
- Improved handling of primitive parameters to ensure they're properly displayed
26+
- Fixed description padding and layout issues in API playground modals
27+
- Enhanced request body type and response body type synchronization with code examples
28+
- Fixed missing query parameter descriptions in API documentation
29+
- Improved performance of API playground inputs to reduce lag during typing
30+
- Object fields now properly respect the `expanded` setting from `docs.json` configuration
31+
- Fixed prefilling from `schema.example` to properly populate example values
32+
- Fixed request example generation for top-level oneOf types
33+
- Fixed type labels to display more accurate information about field types
34+
- Fixed Coinbase playground issues for specific endpoints
35+
- Improved handling of circular schema references to properly render descriptions
36+
- Fixed various API page rendering issues including missing fields and incorrect layouts
37+
38+
## Web editor enhancements
39+
40+
- Branch switching is now fully integrated into the editor UI with improved navigation and state management
41+
- Fixed race condition when committing changes that could cause branch SHA mismatches
42+
- Removed implicit folder directory logic for cleaner file organization
43+
- Fixed file creation and renaming to properly match original file locations in MDX frontmatter
44+
- Improved folder state persistence across editor sessions
45+
- Fixed branch navigation where changing URL to specific branch would redirect incorrectly
46+
- Added merge conflict resolution tracking and improved conflict dialog functionality
47+
- Fixed file state updates after committing changes
48+
- Spaces in file rename inputs are now automatically replaced with dashes for consistency
49+
- Added video support in the editor for embedding video content
50+
- Fixed handling of moving files to previously deleted paths
51+
52+
## Component and styling enhancements
53+
54+
- **Badge component**: New `<Badge>` component for displaying status indicators, labels, and tags with customizable colors
55+
- Images can now be zoomed with improved overlay styling for both light and dark modes
56+
- Fixed image icon backgrounds for dark mode to prevent display issues
57+
- Fixed CardGroup prose styles to ensure proper text formatting within cards
58+
- Fixed italic font rendering issues across the documentation
59+
- Updated gray colors to new design system values for better consistency
60+
- Fixed callouts nested items colors for improved readability
61+
- Fixed font rendering for single code items to use proper monospace fonts
62+
- Improved inline code selection to select only code content on triple-click
63+
64+
## Navigation and UI improvements
65+
66+
- Tab hover indicators now have improved styling with consistent tab titles
67+
- Fixed top-level tabs rendering and navigation
68+
- Fixed page top padding for better visual consistency
69+
- Long words now wrap properly with `overflow-wrap` to prevent horizontal scrolling
70+
- Step component now handles cases where no step title is provided
71+
- Fixed heading IDs to properly handle question marks and special characters for anchor links
72+
- Icon component now accepts `className` prop for custom styling
73+
- Fixed theme toggle colors for better visibility in both light and dark modes
74+
- External links now properly open in new tabs
75+
- Fixed badge position inside navigation group dropdowns
76+
- Improved alignment for table headers and cells with tabular numbers
77+
- Fixed scroll behavior for tables inside tabs and steps inside tabs
78+
79+
## Performance and infrastructure
80+
81+
- Shiki themes are now lazy loaded for improved initial page load performance
82+
- Reduced navigation lag by optimizing prefetching behavior
83+
- KaTeX CSS is now conditionally loaded only when needed, reducing unnecessary asset loading
84+
- Added YAML support to Shiki language constants for better syntax highlighting coverage
85+
- Improved custom font loading user experience with better error handling
86+
87+
## Bug fixes and reliability
88+
89+
- Fixed 500 errors in dashboard caused by Shiki syntax highlighting issues
90+
- Fixed empty expandable objects in API documentation
91+
- Removed example data for additional properties to prevent confusion
92+
- Fixed propagation of required fields in oneOf schemas
93+
- Fixed duplicated descriptions in API documentation
94+
- Fixed missing parent names with dots in schema paths
95+
- Fixed description rendering above tabs for objects with oneOf description combinations
96+
- Improved handling of allOf schemas to properly concatenate descriptions
97+
- Fixed missing defaults with allOf schemas
98+
- Fixed unique key assignment to properly account for array indices in API fields
99+
- Improved error messages for invalid URLs in API configurations
100+
- Fixed playground error display to prevent height shrinking
101+
- Fixed redirect behavior for OAuth to properly include base paths
102+
- Removed dual base path issues in authentication login links
103+
- Fixed sidebar display on non-API pages
104+
- Fixed OG image generation with better truncation logic and Google Fonts support
105+
- Fixed table of contents rendering issues
106+
- Fixed favicon isolation to prevent conflicts between different documentation sites
107+
- Fixed keyboard shortcut styles inside callouts for dark mode
108+
- Fixed Palm theme sidebar styling issues
109+
- Fixed zoomed image overlay background color for light theme
110+
- Fixed scroll height capping for very long API responses
111+
- Fixed button variants for consistent styling across the dashboard
112+
113+
## CLI improvements
114+
115+
- Added error logging for lower Node.js versions to help users identify compatibility issues
116+
- Fixed max file size validation in CLI (increased from 5MB to 20MB)
117+
- Custom syntax highlighting now works properly in CLI local development
118+
- Added early failure if Node 25 is being used with `mint dev` command
119+
- Fixed CLI bugs on Windows and added tests to prevent regressions
120+
121+
## Security enhancements
122+
123+
- Improved redirect validation to prevent XSS and open redirect vulnerabilities
124+
- Enhanced path traversal defense mechanisms
125+
- Disallowed direct access to internal markdown, RSS, and MCP routes via `_mintlify` path
126+
- Improved authentication security with better validation and error handling
127+
- Added validation for organization ownership before setting GitHub sources
128+
129+
## Dashboard improvements
130+
131+
- Fixed dashboard design inconsistencies and improved spacing throughout
132+
- Improved button sizing and layout for organization invitations
133+
- Fixed disabled state for editor publish button
134+
- Added better handling for links in dashboard assistant chat
135+
- Fixed outline issues for chat assistant in Firefox
136+
- Improved deployment history with pagination support
137+
- Added cursor pagination to preview deployments table
138+
- Fixed preview deployments to only return preview environment deployments
139+
- Improved email validation with explicit error messages
140+
- Fixed whitespace handling in email address validation
141+
142+
## Localization
143+
144+
- Added support for additional languages in authentication flows
145+
- Updated translations for contextual menu and assistant features
146+
- Improved language selector functionality across all themes
147+
148+
</Update>
149+
8150
<Update label="November 15" tags={["New releases", "Improvements"]} rss={{ title: "Weekly Updates", description: "Badge component, API playground improvements, custom language support, and performance enhancements" }}>
9151
## New features
10152

0 commit comments

Comments
 (0)