type information (in e.g. doc footers) should link example or source with property information

[prof-milki]

Prerequisites

• Existing Issue: Search the existing issues for this repository. If there is an issue that fits your needs do not file a new one. Subscribe, react, or comment on that issue instead.
• Descriptive Title: Write the title for this issue as a short synopsis. If possible, provide context. For example, "Document new Get-Foo cmdlet" instead of "New cmdlet."

Summary

# type: feature-request
# category: docs
# duplicate-likelihood: 0.75
# did-a-title-search-beforehand: $true
# urgency: low
# severity: medium
# version: 6536e0a

preface

By and large, Powershell docs are fine. Though somewhat insufficient to get Linux devs enthused, I reckon. Due to prevalence and howto article spam, additional information isn't often easy to get by. Unless you have a local Windows install at hand, plus aptitute for live testing.

example

One area that's most lacking is type information. For example windows-powershell-docs/blob/main/docset/winserver2022-ps/hyper-v/Get-VMNetworkAdapter.md does enumerate possible result types, but leaves viewers uninformed about what properties any of 'em would entail.

One can't honestly extrapolate property presence nor naming from other cmdlets in a module.

desired doc details

The "OUTPUTS" section in the (autogenerated?) docs shouldn't just list Microsoft.HyperV.PowerShell.VMNetworkAdapter, but embed a link.

• Ideally it ought to link to another docs page, detailing properties with an examplary example of utmost examplarinies.
• And/or to some source of the pertaining PS module (entirely oblivious if e.g. Hyper-V module is FLOSS).
• Linking to some Cim_Instance documentation is an acceptable (if often more confusing) fallback.

(Found some external samples now, showcasing e.g. mac addresses in the VM network interface object type. Ideally this would be discoverable in official docs however.)

Details

Proposed Content Type

About Topic, Other / Unknown

Proposed Title

Microsoft.HyperV.PowerShell.VMNetworkAdapter type and properties

Related Articles

https://learn.microsoft.com/en-us/powershell/module/hyper-v/get-vmnetworkadapter?view=windowsserver2022-ps&wt.mc_id=ps-gethelp

[officedocspr5]

To make it easier for you to submit feedback on articles on learn.microsoft.com, we're transitioning our feedback system from GitHub Issues to a new experience.

As part of the transition, this GitHub Issue will be moved to a private repository. We're moving Issues to another repository so we can continue working on Issues that were open at the time of the transition. When this Issue is moved, you'll no longer be able to access it.

If you want to provide additional information before this Issue is moved, please update this Issue before December 15th, 2023.

With the new experience, you no longer need to sign in to GitHub to enter and submit your feedback. Instead, you can choose directly on each article's page whether the article was helpful. Then you can then choose one or more reasons for your feedback and optionally provide additional context before you select Submit.

Here's what the new experience looks like.

Note: The new experience is being rolled out across learn.microsoft.com in phases. If you don't see the new experience on an article, please check back later.

First, select whether the article was helpful:

Then, choose at least one reason for your feedback and optionally provide additional details about your feedback:

Article was helpful	Article was unhelpful

Finally, select Submit and you're done!