Redocly-Developer Experience (DX) & Information Architect || Remote role
Contract Independent
Contract Corp To Corp
Contract W2
No Travel Required
Remote
Depends on Experience
Verito Solutions
Fitment
Dice Job Match Score™
✨ Finding the perfect fit...
Job Details
Skills
- Redocly-Developer Experience (DX) & Information Architect
Summary
Redocly-Developer Experience (DX) & Information Architect
Remote role
Long Term Contract
About the Project
We are leading the design and delivery of a unified developer portal for a Fortune 1000 fintech client’s merchant
services API platform. The portal will serve four distinct personas-external developers, internal developers,
business / product users, and AI / automation agents-across ~13 product areas and ~66 APIs spanning
Payments, Refunds, EMV, Subscriptions, Invoices, Webhooks, and more.
The portal is delivered directly in Redocly, with content authored as markdown and OpenAPI / Swagger specs
managed in a GitHub-native workflow. There is no separate engineering build phase-the IA authored in the tool is
what ships. Timeline is tight and outcomes are measurable.
What You Will Do
• Lead the information architecture and content structure for the portal.
• Define persona-differentiated navigation and entry points across the four personas.
• Design the logic that separates internal-only from external APIs within one unified portal.
• Map OpenAPI tags, groups, and operationIds to a scalable sidebar and taxonomy.
• Author reference and guide content directly in the tool, applying developer-first content patterns-reference vs.
tutorial, scannability, copy-paste flows.
• Ensure the IA and content model are consumable by AI agents through structured metadata and chunking.
• Partner with technical writers, API engineers, and client SMEs across a 10 -week delivery cadence.
• Validate the IA through usability sessions with representative users across all four personas.
Must-Have Qualifications
• 8+ years of information architecture, UX architecture, DX design experience, with at least 2 years designing
payments developer-facing products-API portals, SDK documentation, or developer tools.
• Working fluency with OpenAPI / Swagger-you can read and edit specs, and understand tags, servers, and
securitySchemes and how they drive portal navigation.
• Background in payments, fintech, or merchant services domain.
• Hands-on experience with at least one developer portal platform such as Redocly, ReadMe, Stoplight,
Mintlify, or GitBook (Redocly strongly preferred).
• Comfortable in a GitHub-native authoring workflow-markdown, YAML, pull requests, branch-based content
delivery.
• Demonstrated ability to design persona-differentiated IA with clear journey entry points.
• Strong written communication and ability to articulate IA rationale to technical and non-technical stakeholders.
Nice to Have
• Experience in designing the system for AI / LLM consumption-structured content, machine-readable
metadata, retrieval-optimized chunking.
• Prior work on internal + external unified developer documentation portals with role-based visibility.
We are leading the design and delivery of a unified developer portal for a Fortune 1000 fintech client’s merchant
services API platform. The portal will serve four distinct personas-external developers, internal developers,
business / product users, and AI / automation agents-across ~13 product areas and ~66 APIs spanning
Payments, Refunds, EMV, Subscriptions, Invoices, Webhooks, and more.
The portal is delivered directly in Redocly, with content authored as markdown and OpenAPI / Swagger specs
managed in a GitHub-native workflow. There is no separate engineering build phase-the IA authored in the tool is
what ships. Timeline is tight and outcomes are measurable.
What You Will Do
• Lead the information architecture and content structure for the portal.
• Define persona-differentiated navigation and entry points across the four personas.
• Design the logic that separates internal-only from external APIs within one unified portal.
• Map OpenAPI tags, groups, and operationIds to a scalable sidebar and taxonomy.
• Author reference and guide content directly in the tool, applying developer-first content patterns-reference vs.
tutorial, scannability, copy-paste flows.
• Ensure the IA and content model are consumable by AI agents through structured metadata and chunking.
• Partner with technical writers, API engineers, and client SMEs across a 10 -week delivery cadence.
• Validate the IA through usability sessions with representative users across all four personas.
Must-Have Qualifications
• 8+ years of information architecture, UX architecture, DX design experience, with at least 2 years designing
payments developer-facing products-API portals, SDK documentation, or developer tools.
• Working fluency with OpenAPI / Swagger-you can read and edit specs, and understand tags, servers, and
securitySchemes and how they drive portal navigation.
• Background in payments, fintech, or merchant services domain.
• Hands-on experience with at least one developer portal platform such as Redocly, ReadMe, Stoplight,
Mintlify, or GitBook (Redocly strongly preferred).
• Comfortable in a GitHub-native authoring workflow-markdown, YAML, pull requests, branch-based content
delivery.
• Demonstrated ability to design persona-differentiated IA with clear journey entry points.
• Strong written communication and ability to articulate IA rationale to technical and non-technical stakeholders.
Nice to Have
• Experience in designing the system for AI / LLM consumption-structured content, machine-readable
metadata, retrieval-optimized chunking.
• Prior work on internal + external unified developer documentation portals with role-based visibility.
• Exposure to design systems for developer documentation.
• Usability testing experience with developer audiences.
Tools & Stack
Redocly (primary), OpenAPI / Swagger, GitHub, markdown, YAML, Figma (supporting), Miro or equivalent for
journey mapping.
• Usability testing experience with developer audiences.
Tools & Stack
Redocly (primary), OpenAPI / Swagger, GitHub, markdown, YAML, Figma (supporting), Miro or equivalent for
journey mapping.
(“Believe you can and you’re halfway there.”)
– Theodore Roosevelt
Sayantan Das | Senior Tech Recruiter
E:
P: +1 |
Employers have access to artificial intelligence language tools (“AI”) that help generate and enhance job descriptions and AI may have been used to create this description. The position description has been reviewed for accuracy and Dice believes it to correctly reflect the job opportunity.
- Dice Id: 91170457
- Position Id: 19907-40870-
- Posted 2 hours ago
Company Info
About Verito Solutions
At Verito Solutions, our core mission is to be an essential partner in our clients’ success. With a strong vision to become a global leader in delivering innovative and value-driven technology solutions, we are committed to exceeding expectations at every step. Our team is fueled by passion, expertise, and an unwavering determination to provide cutting-edge solutions tailored to the evolving needs of businesses.
We understand the challenges organizations face in today’s fast-paced digital landscape. That’s why we focus on delivering technology solutions that not only enhance efficiency but also save our clients valuable time, money, and effort. Whether it’s optimizing workflows, strengthening cybersecurity, or driving digital transformation, Verito Solutions is dedicated to empowering businesses with seamless, scalable, and future-ready technology.
Create job alert
Never miss an opportunity! Create an alert based on the job you applied for.Similar Jobs
It looks like there aren't any Similar Jobs for this job yet.
Search all similar jobs