Inconsistent behavior and parameter ambiguity in Windows.Management.Deployment.FindPackages API docs

[acs-godonnell]

The documentation for Windows.Management.Deployment.PackageManager.FindPackages(string packageFamilyName) states that it retrieves packages "installed across all users".
Other overloads like FindPackages(string packageName, string packagePublisher) appear to only return packages for the current user.

This inconsistency isn't clearly explained and can lead to incorrect assumptions.

Can the documentation for each Find method specify whether it retrieves packages for all users or just the current user?

Also, the term packageName is ambiguous across the API.
Some methods expect package.Id.Name, others require package.Id.FullName.
The docs should explicitly state which format is expected in each method, with examples to avoid confusion.

Clarifying these points would make the API docs much more reliable for developers.