Performance document should be updated with latest recommendations

[PureWeen]

Type of issue

Out of Date Information

Description

1. ListView section should tell users to just use CollectionView and we should call out not using it inside a "StackLayout"
2. Review these recommendations around image handling

• https://learn.microsoft.com/en-us/dotnet/maui/deployment/performance?view=net-maui-9.0#optimize-image-resources

3. Should we put this on the doc? https://learn.microsoft.com/en-us/dotnet/maui/deployment/performance?view=net-maui-9.0#create-shell-apps or possibly add additional context? We don't want to necessarly trigger people to think that converting to shell will magically fix performance issues
4. Task suggestions https://learn.microsoft.com/en-us/dotnet/maui/deployment/performance?view=net-maui-9.0#fundamentals

• Should we mention Task.Run? Should this section just refer out to other async/await documentation?
• We should probably add a section about making sure to await everything and never just call an async method
• Review this suggestion "Use the Task.Delay method to produce a Task object that finishes after the specified time. This is useful for scenarios such as polling for data, and delaying handling user input for a predetermined time. For more information, see Task.Delay."

5. update this documentation to refer to CollectionView and indicate recommendations about not using an ObservableCollection. We should also discourage users from depending on the auto marshalling behavior of CV
6. Include documentation around IDisposable and how it shouldn't be used on transient services. https://learn.microsoft.com/en-us/dotnet/maui/deployment/performance?view=net-maui-9.0#release-idisposable-resources https://learn.microsoft.com/en-us/dotnet/core/extensions/dependency-injection-guidelines#recommendations

Page URL

https://learn.microsoft.com/en-us/dotnet/maui/deployment/performance?view=net-maui-9.0

Content source URL

https://github.com/dotnet/docs-maui/blob/main/docs/deployment/performance.md

Document Version Independent Id

5845bd05-2151-862c-9b29-1d76664a9f0d

Platform Id

ed86303e-6644-339a-3af0-abd3ffb65a76

Article author

@davidbritch

Metadata

• ID: 5845bd05-2151-862c-9b29-1d76664a9f0d
• PlatformId: ed86303e-6644-339a-3af0-abd3ffb65a76
• Service: dotnet-mobile
• Sub-service: dotnet-maui

Related Issues

[BurningLights]

One note about the second bullet of 4. The animation documentation at https://learn.microsoft.com/en-us/dotnet/maui/user-interface/animation/basic?view=net-maui-9.0 currently suggests using non-awaited async method calls to create compound animations. It would be confusing to then see a recommendation to await everything. Should that portion of the animation documentation be updated to suggest using Task.WhenAny and Task.WhenAll, much like the next section on running multiple animations concurrently?