Windows-itpro-docs: Doc does not make sense

[ghost]

These instructions don't make any sense, previous comments deliver the details on this statement, but no one assigned to this doc seems to be able to understand these comments. So I just post this to increase the counter -- perhaps Microsoft assigns someone who does more than copy-pasting friendly reply snippets to the issue when there are enough posts.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 2a7b356e-3dbd-7f59-845e-a92e05865a52
• Version Independent ID: 711c5497-373f-662c-7fae-ba60f046e50c
• Content: Microsoft Surface Dock Firmware Update - Surface
• Content Source: devices/surface/surface-dock-firmware-update.md
• Product: w10
• Technology: windows
• GitHub Login: @Dansimp
• Microsoft Alias: dansimp

[RAJU2529]

@e0i . Please assign the author of this article, So that author can directly submit comments

[illfated]

To quote jvsam: Or is there a way that we can engage the Product Engineering team to help clarify the feedback?

[e0i]

Hello, @termnews Would you clarify the problematic part(s) about the document? Is it the snippets? We would like to follow up with clarifying updates. Thanks you for providing feedback.

[illfated]

I had to re-read the issue post a couple of times to see the relation, but this is mostly a follow-up response to the content in issue ticket #5756 Some comments about this documentation page and partially #5214 Better describe the update status / better logging , which might be closed soon.

Based on that, I presume this is about the uncertainties around the Microsoft Surface firmware update procedure, which may or may not work as intended & expected, depending on how you read the documentation.

[greg-lindsay]

I should probably be the listed author of this article (although I didn't write it) because I've taken over managing these topics. I will address the issue with the product team and try to rewrite the article, or get it rewritten and then edit and republish.

[e0i]

Apologies to all for the delayed follow-up.

@greg-lindsay Please do let me know whether any independent contributions would be helpful to address this matter. Thank you.

[greg-lindsay]

I did get a reply from the product team. It's long. I'll update the article next week.

[greg-lindsay]

The reply I have still doesn't enable me to update this article. I have obtained a surface dock myself and I'm going to try and follow the docs myself. I've also pinged the product team for another reply in the meantime.

[greg-lindsay]

See https://github.com/MicrosoftDocs/windows-itpro-docs/issues/5756 for an update I'm going to use that issue as the main one and close this one.