Skip to content

Conversation

davidortinau
Copy link
Contributor

@davidortinau davidortinau commented Aug 21, 2025

This PR updates the .NET 10 “What’s new” article with the rollup of features we documented across focused PRs, with cross-links to the underlying topics. It follows the conceptual policy to avoid minor API-surface churn and focuses on meaningful usage guidance.

Scope

  • Page: docs/whats-new/dotnet-10.md
  • ms.date refreshed to 2025-08-21
  • Added/updated sections:
    • Shell: NavBarVisibilityAnimationEnabled toggle
    • SearchHandler: ShowSoftInputAsync/HideSoftInputAsync; trimming caveat pointer for DisplayMemberName
    • WebView (Android): JavaScript enable/disable note (links to article)
    • HybridWebView: init customization section link (RunAfterInitialize on Windows; handler access on Android/iOS/macOS)
    • Pickers: nullable DatePicker/TimePicker selection; retained Open/Close programmatic control
    • Page.IsBusy: corrected guidance to prefer ActivityIndicator for page/view busy UX
  • Removed minor API-surface-only notes per our policy (e.g., internal→public exposure items)

Cross-links to topic PRs (for reviewer context)

Acceptance checks

  • Balanced links; no fragile anchors introduced (WebView JS toggle links to article root)
  • Monikers: not used on this page; outbound links use ?view=net-maui-10.0
  • Lint: headings and lists follow established patterns

Once merged, I’ll add this PR link back to the tracker (ISSUE-TRACKER.NET10-MAUI-Docs.md) under “What’s new”. Thanks!


Internal previews

📄 File 🔗 Preview link
docs/whats-new/dotnet-10.md docs/whats-new/dotnet-10

…ler keyboard/trimming note, WebView Android JS toggle, HybridWebView init customization, nullable Date/TimePicker, Page.IsBusy guidance).
@davidortinau davidortinau requested a review from a team as a code owner August 21, 2025 14:26
@davidortinau davidortinau requested a review from Copilot August 21, 2025 14:26
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR consolidates .NET MAUI .NET 10 feature documentation into a comprehensive "What's new" article, providing cross-references to detailed topic coverage while following the established policy of avoiding minor API surface change callouts.

  • Adds rollup sections for Shell navigation bar animation, SearchHandler soft input controls, WebView JavaScript configuration, HybridWebView initialization customization, and nullable picker selections
  • Updates Page.IsBusy guidance to recommend ActivityIndicator instead of global busy states
  • Removes minor API visibility change notes (StackNavigationManager, TabbedPageManager, ShadowTypeConverter) per documentation policy

@@ -1,7 +1,7 @@
---
title: What's new in .NET MAUI for .NET 10
description: Learn about the new features introduced in .NET MAUI for .NET 10.
ms.date: 05/13/2025
ms.date: 08/20/2025
Copy link
Preview

Copilot AI Aug 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The ms.date should be 08/21/2025 to match the description which states 'ms.date refreshed to 2025-08-21'.

Copilot uses AI. Check for mistakes.

In .NET 10, the `ShadowTypeConverter` class, in the `Microsoft.Maui.Controls` namespace, is now public.

For more information about how shadows can be specified using formatted strings, see [Shadow](~/user-interface/shadow.md).
<!-- Removed minor API-surface-only note per docs policy: avoid conceptual notes for visibility changes. -->
Copy link
Preview

Copilot AI Aug 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This HTML comment should be removed as it's not necessary for the published documentation and adds clutter to the source.

Suggested change
<!-- Removed minor API-surface-only note per docs policy: avoid conceptual notes for visibility changes. -->

Copilot uses AI. Check for mistakes.

Copy link

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Copy link

Learn Build status updates of commit c64772d:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/whats-new/dotnet-10.md ⚠️Warning View (>=net-maui-8.0) Details

docs/whats-new/dotnet-10.md

  • Line 81, Column 250: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#customize-initialization-and-access-platform-web-views' in 'user-interface/controls/hybridwebview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant