Skip to content

Add version tags, update nav, and improve form docs - #1315

Merged
gvreddy04 merged 14 commits into
mainfrom
features/v4.0.0-post-release-documentation-updates
Aug 31, 2026
Merged

Add version tags, update nav, and improve form docs#1315
gvreddy04 merged 14 commits into
mainfrom
features/v4.0.0-post-release-documentation-updates

Conversation

@gvreddy04

@gvreddy04 gvreddy04 commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

The main changes include reordering and correcting navigation items, updating documentation image URLs for better relevance, and making minor improvements to documentation and navigation links.

Navigation structure and consistency:

  • Fixed the order and IDs of several navigation items in both DemosMainLayout.razor.cs and DocsMainLayout.razor.cs to ensure consistent display and correct grouping, including moving "Drag and Drop File Input" and "RichTextEditor" to the correct positions and updating IDs for "Modals" and "Split View" components.

Documentation improvements:

  • Updated the imageUrl constants in documentation files for DragAndDropFileInput, FileInput, OTPInput, and RichTextEditor to use more specific and relevant screenshot URLs, and added the ImageUrl property to the metadata for the RichTextEditor docs page.

Content and text enhancements:

  • Clarified the description of SplitView's nested layouts in its documentation to mention support for app-shell workspaces and navigation/inspector panes.

Component and API improvements:

  • Updated the DocxEventCallbackRow component to pass VersionContextType to GetPropertyAddedVersion and exposed VersionContextType as a [Parameter], enabling more context-aware version information in docs tables.

Navigation link behavior:

  • Changed the "Docs" link in EmptyLayout.razor to open in the same tab instead of a new tab, aligning its behavior with other navigation links.
Added [AddedVersion] to all form inputs. Updated navigation IDs and order for "Forms" and "Components" in layouts. Refreshed screenshot URLs for several inputs. Updated all demo/doc links to new /demos/ route. Improved SplitView docs and added OTPInput docs. Adjusted sidebar positions and ensured correct version context in doc tables. Clarified content and accessibility in file input docs. Made minor text improvements throughout documentation.
@gvreddy04 gvreddy04 self-assigned this Aug 31, 2026
Add and improve XML documentation and metadata attributes (e.g., [AddedVersion], [Description], [DefaultValue]) for various Blazor components. Document and decorate public properties, especially [Parameter]s, to clarify usage, default values, and versioning. Introduce and document Disable()/Enable() methods for programmatic control. Update [JSInvokable] methods with XML docs. Improve ValueExpression property documentation and metadata. Refine property and event callback docs for better API clarity and maintainability.
Add Disabled and other parameters to input components for improved configurability. Annotate with [DefaultValue] and [Description] for better API clarity. Introduce EditContext as [CascadingParameter] in some components. Focus on usability, accessibility, and documentation improvements.
Added [DefaultValue] attributes and detailed <remarks> documentation to parameters in CheckboxInput, RadioInput, PasswordInput, RichTextEditor, TextAreaInput, and TextInput. Clarified default values and improved API docs for parameters like Label, Value, Name, MaxLength, Cols, Rows, AllowedImageDomains, AllowedImageFileTypes, AllowedLinkDomains, and ShowHidePasswordButtonCssClass.
Enhanced [Description] attributes for clarity and completeness. Added or corrected [DefaultValue] attributes and default values for parameters. Applied [JSInvokable] to enable JavaScript interop on relevant methods and parameters. Reformatted private cascading parameters for consistency. These changes improve maintainability, API documentation, and JS interop support.
Updated XML comments and Description attributes for DateInput, NumberInput, TextAreaInput, TextInput, and TimeInput. Enhanced clarity, consistency, and user focus in documentation. No changes to runtime behavior; improvements are limited to code documentation and API descriptions.
Update and clarify XML documentation comments and [Description] attributes for Blazor input components. Enhance descriptions to specify component behavior, user interaction, and parameter effects. No functional changes; only documentation improved for API clarity.
Added SelectedFiles property to FileInputBase. Enhanced RichTextEditor ToolbarItems with version, default, and description attributes. Reordered attributes in RichTextEditorToolbarButton for consistency.
Enhanced and clarified XML documentation comments for all public
members of the SplitView component. Added detailed summaries,
parameter descriptions, default values, and usage notes for
properties, events, and JS-invokable methods to improve API
discoverability and developer experience.
- Changed "Docs" link in EmptyLayout.razor to open in same tab
- Updated blog URL in appsettings.json to absolute URL
- Imported and rendered CarbonAd in rich-text-editor.mdx after heading
Added drag-and-drop-file-input.png, file-input.png, otp-input.png, and rich-text-editor.png as image assets for UI illustrations or documentation screenshots.
Added illustrative screenshots to the documentation of DragAndDropFileInput, FileInput, RichTextEditor, and SplitView components. Screenshots are placed after the introduction and before parameters/usage, providing visual previews. No other content was changed.
Added DragAndDropFileInput, FileInput, OTPInput, RichTextEditor, and SplitView to the Blazor Bootstrap documentation and README. Each entry includes links to documentation, demos, and a screenshot section.
Added a new PNG image file named enum-input.png to the project. No code changes were made.
@gvreddy04 gvreddy04 modified the milestones: 4.1.0, 4.0.0 Aug 31, 2026
@gvreddy04
gvreddy04 merged commit 9c5d655 into main Aug 31, 2026
1 of 3 checks passed
@gvreddy04
gvreddy04 deleted the features/v4.0.0-post-release-documentation-updates branch August 31, 2026 17:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant