Skip to content

Conversation

@learn-build-service-prod
Copy link

This PR was automatically created by Auto Publish system to publish changes from the main branch to the live branch.

TrickyCat and others added 10 commits June 6, 2025 16:02
```csharp
// builder.Services.AddSingleton<IOfflineSpeechToText>(OfflineSpeechToText.Default);
```


The comment currently suggests using `IOfflineSpeechToText` for offline recognition, but that interface doesn’t exist.I checked the sample project, and it looks like `ISpeechToText` is used for both online and offline modes.
* Initial changes based on the rework for Popup

* Popup v2 rework

* Update docs/maui/views/popup/popup-options.md

Co-authored-by: Pedro Jesus <pedrojesus.cefet@gmail.com>

* PopupService improvements

* Further improvements

* Include new pages in the TOC

* Move note to part of the main text

* Improve the code examples

* Add images to docs

* PopupService code corrections

* Improvements based on review

* Correct close method name

* Remove unused image

* Improve the code readibility

* Update docs/maui/views/popup/popup-result.md

Co-authored-by: Brandon Minnick <13558917+TheCodeTraveler@users.noreply.github.com>

* Rework based on review comments

* Fix validation issues

* Fix validation issues

* Correct path

* Apply suggestions from code review

Co-authored-by: Brandon Minnick <13558917+TheCodeTraveler@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Brandon Minnick <13558917+TheCodeTraveler@users.noreply.github.com>

* Make close examples async

---------

Co-authored-by: Shaun Lawrence <17139988+bijington@users.noreply.github.com>
Co-authored-by: Pedro Jesus <pedrojesus.cefet@gmail.com>
Co-authored-by: Brandon Minnick <13558917+TheCodeTraveler@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>
Remove Handler disconnect for media element. No longer needed with dotnet 9.x

Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>
* Add references to Texture View and how to use it.

* Update docs/maui/views/MediaElement.md

Co-authored-by: Brandon Minnick <13558917+TheCodeTraveler@users.noreply.github.com>

* Update docs/maui/views/MediaElement.md

Co-authored-by: Brandon Minnick <13558917+TheCodeTraveler@users.noreply.github.com>

* Add codebehind and xaml examples. Provide message about overriding builder and that each media element can be set individually.

---------

Co-authored-by: Brandon Minnick <13558917+TheCodeTraveler@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>
* Update animation-behavior.md

* Update animation-behavior.md

---------

Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>
…aPreview` and `CameraView.StopCameraPreview` (#553)

* Update email-validation-behavior.md

* Add .NET Hot Reload Docs

* Add C# Examples

---------

Co-authored-by: Brandon Minnick <13558917+brminnick@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald@verslu.is>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>
@learn-build-service-prod
Copy link
Author

Learn Build status updates of commit 3bac865:

💡 Validation status: suggestions

File Status Preview URL Details
docs/maui/views/Popup.md 💡Suggestion View Details
docs/maui/views/popup/popup-options.md 💡Suggestion View Details
docs/maui/views/popup/popup-result.md 💡Suggestion View Details
docs/high-performance/Memory2D.md ✅Succeeded View
docs/high-performance/ParallelHelper.md ✅Succeeded View
docs/high-performance/Span2D.md ✅Succeeded View
docs/high-performance/SpanOwner.md ✅Succeeded View
docs/maui/behaviors/animation-behavior.md ✅Succeeded View
docs/maui/essentials/speech-to-text.md ✅Succeeded View
docs/maui/images/views/popup/popup-blue-border.png ✅Succeeded View
docs/maui/images/views/popup/popup-green-shadow.png ✅Succeeded View
docs/maui/images/views/popup/popup-no-border.png ✅Succeeded View
docs/maui/images/views/popup/popup-no-shadow.png ✅Succeeded View
docs/maui/images/views/popup/popup-page-overlay-opaque.png ✅Succeeded View
docs/maui/images/views/popup/popup-page-overlay-translucent.png ✅Succeeded View
docs/maui/images/views/popup/popup-result.png ✅Succeeded View
docs/maui/images/views/popup/popup-with-button.png ✅Succeeded View
docs/maui/images/views/popup/popup-with-padding.png ✅Succeeded View
docs/maui/TOC.yml ✅Succeeded View
docs/maui/views/camera-view.md ✅Succeeded View
docs/maui/views/MediaElement.md ✅Succeeded View
docs/maui/views/popup-service.md ✅Succeeded View

docs/maui/views/Popup.md

  • Line 73, Column 1: [Suggestion: image-structure-incorrect - See documentation] Invalid image path 'maui/images/views/popup/popup-with-padding.png'. Images should be placed in a /media folder adjacent to the file where they are rendered, and in a subfolder matching the article name.

docs/maui/views/popup/popup-options.md

  • Line 39, Column 1: [Suggestion: image-structure-incorrect - See documentation] Invalid image path 'maui/images/views/popup/popup-page-overlay-opaque.png'. Images should be placed in a /media folder adjacent to the file where they are rendered, and in a subfolder matching the article name.
  • Line 50, Column 1: [Suggestion: image-structure-incorrect - See documentation] Invalid image path 'maui/images/views/popup/popup-page-overlay-translucent.png'. Images should be placed in a /media folder adjacent to the file where they are rendered, and in a subfolder matching the article name.
  • Line 68, Column 1: [Suggestion: image-structure-incorrect - See documentation] Invalid image path 'maui/images/views/popup/popup-blue-border.png'. Images should be placed in a /media folder adjacent to the file where they are rendered, and in a subfolder matching the article name.
  • Line 83, Column 1: [Suggestion: image-structure-incorrect - See documentation] Invalid image path 'maui/images/views/popup/popup-no-border.png'. Images should be placed in a /media folder adjacent to the file where they are rendered, and in a subfolder matching the article name.
  • Line 100, Column 1: [Suggestion: image-structure-incorrect - See documentation] Invalid image path 'maui/images/views/popup/popup-green-shadow.png'. Images should be placed in a /media folder adjacent to the file where they are rendered, and in a subfolder matching the article name.
  • Line 115, Column 1: [Suggestion: image-structure-incorrect - See documentation] Invalid image path 'maui/images/views/popup/popup-no-shadow.png'. Images should be placed in a /media folder adjacent to the file where they are rendered, and in a subfolder matching the article name.

docs/maui/views/popup/popup-result.md

  • Line 156, Column 1: [Suggestion: image-structure-incorrect - See documentation] Invalid image path 'maui/images/views/popup/popup-result.png'. Images should be placed in a /media folder adjacent to the file where they are rendered, and in a subfolder matching the article name.

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.

@michael-hawker
Copy link
Collaborator

michael-hawker commented Jun 11, 2025

We should leave this as-is and not merge for now, awaiting further instructions from the docs team. This was created as part of an automated workflow, but failed to merge for some reason.

FYI @TheCodeTraveler, thanks for the heads up about the doc sync. I'm working with the docs team to figure out how to re-enable publishing (there's been some changes in this space moving from auto-triggered to nightly chron job). I'm waiting for next steps to see what to do here, as this was supposed to be automatically merge, so need to understand what the proper step to restore state is.

In the meantime, be sure to look at the validation suggestions for the future for the image locations. Seems like something we may want to audit across the repo. @alvinashcraft is their guidance on the image stuff somewhere we can reference? The "see documentation" link for the suggestion 404s for me: https://learn.microsoft.com/help/platform/validation-ref/image-structure-incorrect

@michael-hawker michael-hawker merged commit f5d955a into live Jun 11, 2025
2 checks passed
@michael-hawker
Copy link
Collaborator

Merging as per docs team instructions.

@alvinashcraft
Copy link

In the meantime, be sure to look at the validation suggestions for the future for the image locations. Seems like something we may want to audit across the repo. @alvinashcraft is their guidance on the image stuff somewhere we can reference? The "see documentation" link for the suggestion 404s for me: https://learn.microsoft.com/help/platform/validation-ref/image-structure-incorrect

I'm not sure where that link should be going but the page doesn't exist. These are the new rules they recently put in place (on Sunday). They're only Suggestions for existing content but are Warnings for any new content and will impact the content quality score of those articles. I'll send you a link to the Teams channel with a post about this. I'm trying to find where the new rules are all publicly documented. Here's one of the new rules that is documented: https://learn.microsoft.com/en-us/help/platform/validation-ref/filename-contains-stop-word

  • Gerunds: Avoid using gerunds in filenames and folder names for better SEO.
  • Incomplete Words: Ensure folder names contain complete words with correct spelling and allowed abbreviations.
  • Invalid Characters: Use only lowercase letters, numbers, and hyphens in filenames, folders, and images.
  • Max Length: File, folder, and image names must be 80 characters or less.
  • Stopwords: Remove unnecessary stop words from filenames.
  • Redundancy: Avoid redundancies in file paths. For example, if a product name is already in the folder name, don’t repeat it in the subfolder name.
  • Image and Include Folder Structure: Follow specific structure for images and include files. Images and include files must be in a folder adjacent to the file that references the image or include.

@bijington
Copy link
Collaborator

bijington commented Jun 11, 2025

I saw on one of our PRs #552 that merged the warning for images not being in the adjacent folder were reported. If these cause a failure to publish then surely they should be errors to prevent a PR from merging?

@alvinashcraft
Copy link

Suggestions and warnings shouldn't cause a failure to publish, but warnings will impact the content quality scores we use. I was told that they're finding that the new rules for resources being in folders adjacent to files aren't practical for some repos, so I think they may be reconsidering how they enforce those particular rules.

@bijington
Copy link
Collaborator

Oh great! We could technically move our images if we needed but it would be great if we don't need to

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.

9 participants