AI Documentation Specialist
An AI Documentation Specialist creates, curates, and maintains technical documentation for AI systems, APIs, SDKs, and machine lea…
Skill Guide
The application of specific technical and procedural standards to ensure digital content (documentation, UI text, code comments) is usable by people with disabilities (Accessibility) and easily adapted for different languages and cultural contexts (Internationalization).
Scenario
You are given the URL for a single page of a fictional API documentation site (e.g., a Getting Started guide).
Scenario
Build a reusable 'Code Sample' component in a framework like React or Vue that includes a code block, a 'copy' button, and a language toggle, designed for translation.
Scenario
Propose and design an automated CI/CD pipeline for a company's documentation repository that gates merging based on a11y and i18n checks.
WCAG is the legally-backed standard for web accessibility. ARIA APG provides the blueprint for making complex UI widgets accessible. Unicode CLDR is the industry-standard source for locale-specific data (date formats, time zones, etc.).
Axe and WAVE are browser extensions for manual/automated a11y audits. TMS platforms manage translation workflows and maintain glossaries. Pseudo-l10n tools (e.g., as a build script) automatically test string externalization.
Shift-Left means integrating a11y/i18n from the first design and PR, not the final QA. Design Tokens can store locale-specific values (e.g., a 'direction' token). A Global-Ready Checklist is a tactical document for reviewing any piece of content or component.
Answer Strategy
The interviewer is testing strategic planning and prioritization. Use a phased approach. Sample Answer: 'Sprint 1: Audit and refactor the build system to externalize all UI strings into resource bundles and implement a locale-aware routing mechanism. Sprint 2: Integrate a TMS like Crowdin, import the string files, and produce a pilot translation of 2-3 core pages for a target locale (e.g., Japanese). Sprint 3: Update all documentation templates and components to handle text expansion, implement a locale switcher, and establish a pseudo-localization step in the CI pipeline to catch regressions.'
Answer Strategy
This tests collaboration and technical depth. Focus on providing solutions, not just problems. Sample Answer: 'I would leave a respectful comment in the PR, linking to the relevant ARIA APG pattern for a 'Code Editor'. My feedback would be specific: 1. The custom buttons need an `aria-pressed` state to indicate activation. 2. The code output area must be a live region with `aria-live="polite"` to announce results to screen readers. 3. All interactive elements must be keyboard-navigable in a logical order. I'd offer to pair-program on the fix to ensure it's done correctly and efficiently.'
1 career found
Try a different search term.