Back to projects

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 completed Developer Center
Completed Microsoft Identity Developer Center landing page, with the identity platform introduction and Browse by use case pathways for employees and partners, customers, applications and services, and digital credentials.

The main landing page brings product use cases, learning resources and implementation guidance into one developer experience.

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.

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.

The original starting point

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
Original Microsoft Identity Platform landing page, showing Microsoft Entra featured solutions with separate Learn more links for workforce identity, customer identity, permissions management, verified identity, workload identities and Microsoft Graph.
Documentation as an entry point

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
Historical Microsoft Learn Workload ID documentation landing page, with a navigation sidebar and documentation resources grouped under overview and how-to guide headings.
An existing developer experience

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
Existing Microsoft Entra ID for customers developer page, with a customer identity introduction, featured developer resources, code samples and implementation tutorials.

The project needed to bring these different entry points into a more coherent developer experience, while keeping Microsoft Learn as a technical resource.

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.

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.

Simplified information architecture — retrospective illustration
Microsoft Identity Developer Center
  1. Microsoft Entra ID

    Identity management for employees and partners

  2. Microsoft Entra External ID

    Customer identity and access management

  3. Microsoft Entra Workload ID

    Identity management for applications and services

  4. Microsoft Entra Verified ID

    Decentralised digital credentials

Each supporting page provides pathways into relevant documentation, tutorials, guides and code samples, depending on the product.

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.

Illustrative reconstruction based on the published experience
Section

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

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.

01 / New developer page

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.

Completed Microsoft Entra ID developer landing page. Identity fundamentals, practical application development, authentication libraries, security guidance and code samples form a progression from understanding identity to building with it.

Detail: identity fundamentals, learning and application development.

02 / Redesigned developer page

Microsoft Entra External ID

Developer resources are grouped around identity basics, features and deployment, followed by application-specific code samples, tutorials and implementation guidance.

Completed Microsoft Entra External ID developer landing page. Developer resources are grouped around identity basics, features and deployment, followed by application-specific code samples, tutorials and implementation guidance.

Detail: developer resources, code samples and tutorials.

03 / New developer page

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.

Completed Microsoft Entra Workload ID developer landing page. Key workload-identity concepts introduce the subject before distinct explanations of applications, service principals and managed identities, with pathways into technical guides.

Detail: workload concepts and identity types.

04 / New developer page

Microsoft Entra Verified ID

Practical use cases introduce verifiable credentials before pathways into technical resources, code samples and implementation guidance.

Completed Microsoft Entra Verified ID developer landing page. Practical use cases introduce verifiable credentials before pathways into technical resources, code samples and implementation guidance.

Detail: essentials and practical uses for verifiable credentials.

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.

Alongside the Developer Center project, I developed educational and product content for the Microsoft Identity developer blog.

View all my Microsoft developer articles
Opens in a new tab