Config option "mirrored" networking mode need adequate documentation (23H2)

[Boilerplate4u]

Documentation Issue

While the "mirrored" networking mode in WSL may offer several advantages over the old configuration options, it lacks in-depth documentation on how to set up more advanced configurations like a network bridge. This aspect of the documentation requires urgent improvement.

For example, a network bridge in the context of WSL allows the instance to appear as a separate device on the physical network, offering several benefits:

• Direct external access: Devices on your network can communicate directly with the WSL instance using its own IP address.

• Enhanced services: You can run services within WSL (e.g., web servers, databases) that are accessible from other devices on the network without complex port forwarding.

• Flexible network scenarios: Bridging enables more advanced networking setups, potentially useful for development and testing.

Why the documentation needs improvement:

• Focus on basic mirrored mode: Most documentation centers around enabling the base "mirrored" mode without going into the complexities of bridging like how the interfaces are interconneced, etc.

• Lack of clear examples: There aren't enough practical, step-by-step guides on how to create a functional bridge for common use cases.

• Assumption of internal expertise: The current resources expect users to have a deep understanding of WSL internals and Linux networking tools and bridging concepts.

Link to documentation page

https://learn.microsoft.com/en-us/windows/wsl/networking

Suggested Improvements

Why the documentation needs improvement:

• Focus on basic mirrored mode: Most documentation centers around enabling the base "mirrored" mode without going into the complexities of bridging like how the interfaces are interconneced, etc.

• Lack of clear examples: There aren't enough practical, step-by-step guides on how to create a functional bridge for common use cases.

• Assumption of internal expertise: The current resources expect users to have a deep understanding of WSL internals and Linux networking tools and bridging concepts.

[craigloewen-msft]

Tagging @chanpreetdhanjal for visibility