Microsoft Identity Developer Center
From documentation links to a connected developer experience.
Content design · Information architecture · UX writing
- Role
- Content Developer (Product & UX)
- Period
- 2023–2024

The main landing page brings product use cases, learning resources and implementation guidance into one developer experience.
The challenge
Microsoft's identity platform brought together products covering authentication, access management and identity verification.
Developers arriving at the existing landing page were directed to a mixture of product resources and Microsoft Learn documentation pages. Most product areas lacked a dedicated developer-facing landing page, making it harder to establish a consistent journey from understanding a solution to implementing it.
The objective was to improve content discoverability and create clearer pathways into Microsoft's identity products and developer resources.
The starting experience
Before the redevelopment, the platform landing page directed developers to a mixture of product information, Microsoft Learn documentation and other resources.
For several identity products, documentation landing pages served as the main entry point. Customer identity was an exception: it already had a dedicated developer landing page.
Original Microsoft Identity Platform landing page
The existing page introduced Microsoft's identity solutions and directed visitors towards product information and developer resources.
View full original page
Microsoft Entra Workload ID documentation
For product areas without a dedicated developer page, the Microsoft Learn documentation landing page effectively served as the main product entry point.
View full documentation page
Existing customer identity developer page
Customer identity already had a dedicated developer landing page, which was subsequently revised to align with the new experience.
View full customer identity page
The project needed to bring these different entry points into a more coherent developer experience, while keeping Microsoft Learn as a technical resource.
My contribution
I led the content design work for the main Developer Center and four supporting identity-product pages.
I audited existing content and planned the information architecture, page structures and content hierarchy. This included determining which technical resources to feature, how to group and prioritise them, and how to guide developers between product information, learning resources and implementation guidance.
I created spreadsheet-based content specifications covering section layouts, headings, descriptions, calls to action and resource links.
Working with product and engineering teams, I collaborated with an external design agency as these content structures were translated into wireframes and subsequently delivered.
Designing the content architecture
I organised the Developer Center around four identity areas, giving developers a clear starting point based on what they wanted to build.
The main landing page introduced each area through a practical use case. Dedicated supporting pages then brought together relevant concepts, tutorials, code samples and documentation, providing context before directing developers into more detailed technical resources.
Microsoft Entra ID
Identity management for employees and partners
Microsoft Entra External ID
Customer identity and access management
Microsoft Entra Workload ID
Identity management for applications and services
Microsoft Entra Verified ID
Decentralised digital credentials
Each supporting page provides pathways into relevant documentation, tutorials, guides and code samples, depending on the product.
From content planning to page design
I created spreadsheet-based specifications for the main landing page and supporting pages, defining section order, headings, descriptions, calls to action and resource destinations.
These specifications helped translate the intended content hierarchy into layouts that could be developed collaboratively with product, engineering and an external design agency.
Browse by use case
- Developer need
- Identify the Microsoft identity solution relevant to applications and services.
- Content decision
- Introduce a distinct use-case pathway on the main Developer Center landing page, rather than requiring visitors to identify the appropriate product from documentation alone.
- Published example
- Identity management for applications and services
- Destination
- Microsoft Entra Workload ID developer page
A consistent experience across four identity areas
The completed supporting pages shared a consistent approach to presenting developer content while accommodating the needs of each identity product.
Each page provided an introduction to its subject and organised relevant information into pathways for learning, building and exploring technical resources.
Microsoft Entra ID
Identity fundamentals, practical application development, authentication libraries, security guidance and code samples form a progression from understanding identity to building with it.
Microsoft Entra External ID
Developer resources are grouped around identity basics, features and deployment, followed by application-specific code samples, tutorials and implementation guidance.
Microsoft Entra Workload ID
Key workload-identity concepts introduce the subject before distinct explanations of applications, service principals and managed identities, with pathways into technical guides.
Microsoft Entra Verified ID
Practical use cases introduce verifiable credentials before pathways into technical resources, code samples and implementation guidance.
The delivered experience
The redevelopment introduced a connected Microsoft Identity Developer Center with four supporting identity-product pages.
Three dedicated developer pages were newly introduced for Entra ID, Workload ID and Verified ID, while the existing customer identity page was updated to align with the new experience.
The result was a consistent content structure that provided developers with context and pathways into relevant technical resources.
Selected technical writing
Alongside the Developer Center project, I developed educational and product content for the Microsoft Identity developer blog.
Understanding the essentials of identity and access management (IAM)
An introduction to IAM concepts, including authentication, authorisation and identity technologies.
Adding flexibility to authentication with Microsoft Entra External ID custom extensions
Developer-focused content explaining custom authentication extensions and practical implementation scenarios.



