Windows-itpro-docs: Navigation is inconsistent between deployment types and missing information

Created on 17 Oct 2019  Â·  4Comments  Â·  Source: MicrosoftDocs/windows-itpro-docs

I began working on trying to update the docs but I'm in over my head. We began trying to use the docs to walk through using Hybrid Key trust for AAD Joined devices to enabled SSO with Windows Hello for Business to allow access to on-premises domain resources. Through the process, we found that several areas are confusing or incomplete.

  1. The use of the word Hybrid throughout the docs seems to be getting mixed between Hybrid identity and Hybrid Azure AD Join. There needs to be some clarification throughout the docs when these words are used. Considering you can have a Hybrid Key trust for Hybrid Azure AD Joined devices and Hybrid Key trust for AAD Joined devices, this can get very confusing.

  2. The Azure AD Join Single Sign-on Deployment Guides should be broken into the same separate doc structure that the other 2 guides above it are in.
    https://docs.microsoft.com/en-us/windows/security/identity-protection/hello-for-business/hello-hybrid-aadj-sso

  3. Azure AD Join Single Sign-on Deployment Guides - this name is confusing. This is really the guide for Hybrid Key trust for AAD Joined devices and Hybrid Certificate trust for AAD Joined devices.

  4. The Azure AD Join Single Sign-on Deployment Guides should include the same (or similar) pages as are included here - using the blue navigation on the bottom.
    https://docs.microsoft.com/en-us/windows/security/identity-protection/hello-for-business/hello-hybrid-key-whfb-settings
    https://docs.microsoft.com/en-us/windows/security/identity-protection/hello-for-business/hello-hybrid-key-whfb-settings-ad
    https://docs.microsoft.com/en-us/windows/security/identity-protection/hello-for-business/hello-hybrid-key-whfb-settings-dir-sync
    https://docs.microsoft.com/en-us/windows/security/identity-protection/hello-for-business/hello-hybrid-key-whfb-settings-pki
    https://docs.microsoft.com/en-us/windows/security/identity-protection/hello-for-business/hello-hybrid-key-whfb-settings-policy

Hopefully this makes sense. Please let me know if you need clarification on these issues.


Document Details

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

hello-for-business

Most helpful comment

Is there anyone even monitoring these issues? This is absurd. The topic is HUGELY important and a large key to enabling enterprises to be successful with Windows Hello for Business and on-premises AD resources. Yet no one has responded or updated these docs to help improve their usability. I have spent countless hours trying to make sense of this and attempt to update the docs but it’s such a mess that I’m in over my head. Please have someone make this a priority.

All 4 comments

@mapalko Would you be able to follow-up with this editorial issue? It seems the problem is beyond the capacity of our team. Let us know in any ways that we can help. Thanks.

Any update on this issue? This whole topic needs to be reorganized and have more consistent language and navigation. Several sub pages aren’t available from the TOC either.

Any update on this?

Is there anyone even monitoring these issues? This is absurd. The topic is HUGELY important and a large key to enabling enterprises to be successful with Windows Hello for Business and on-premises AD resources. Yet no one has responded or updated these docs to help improve their usability. I have spent countless hours trying to make sense of this and attempt to update the docs but it’s such a mess that I’m in over my head. Please have someone make this a priority.

Was this page helpful?
0 / 5 - 0 ratings

Related issues

RAJU2529 picture RAJU2529  Â·  3Comments

ang216 picture ang216  Â·  3Comments

thohun picture thohun  Â·  3Comments

SwiftOnSecurity picture SwiftOnSecurity  Â·  3Comments

andrewpong picture andrewpong  Â·  3Comments