Job Purpose
Own endtoend documentation for Capital Market platforms and other financial and banking applications critical for global banks. Establish the documentation strategy, produce highquality developer and operator content, and create a sustainable docsascode practice that accelerates onboarding, reduces support burden, and improves change velocity.
Work crossfunctionally with business, engineering and delivery teams in the App Dev workstream;
Desired Skills And Experience
- 812 years of technical writing experience, with 5+ years on complex enterprise platforms (preferably banking/capitalmarkets).
- Demonstrated ownership of a developer portal or large product documentation set (architecture API operations).
- Strong ability to read code/configs and interrogate systems: familiarity with API exploration (Swagger/Postman), logs and dashboards, and basic scripting/SQL to validate flows.
- Tooling: Markdown, static site generators (MkDocs/Sphinx/Docusaurus), OpenAPI/Swagger, diagramming (Mermaid/draw.io/Visio), Confluence; comfortable working in GitHub/Azure DevOps and CI (e.g., Jenkins).
- Exceptional structuring, editing, and stakeholder management ; can transform tribal knowledge into clean, reusable artifacts.
- Portfolio required: 23 samples of API/SDK docs and one architecture/runbook example (links or PDFs).
- Background documenting platform integrations (APIs/SDKs, data extract/load patterns, SFTP and batch pipelines) and governed data sets.
- Exposure to capitalmarkets workflows and middle/backoffice systems.
Key Responsibilities
- Own the Platform documentation portfolio: architecture overviews, service/component guides, integration patterns, API/SDK reference, data contracts, runbooks/SOPs, troubleshooting guides, and release notes.
- Establish documentation standards & IA: define templates, taxonomy, versioning, and content lifecycle; implement style and terminology guides aligned to CLIENT expectations.
- Adopt a docsascode workflow: source control, PR reviews, automated build & publish (MkDocs/Sphinx/Docusaurus or other documentation platforms), search, and link integrity checks; integrate with GitHub/Azure DevOps and CI (e.g., Jenkins).
- Author API/SDK content: collaborate with developers to produce OpenAPI/Swaggerdriven reference, code snippets, authentication/authorization flows, ratelimits, and usage examples.
- Document data flows: capture upstream/downstream dependencies, batch/nearrealtime ingestion patterns, data validation/audit trails, and operational guardrails; maintain data dictionaries and lineage notes where applicable.
- Create operatorgrade runbooks: incident playbooks, SLO/SLA documentation, monitoring/alerting handbooks, change management checklists, and rollback procedures.
- Partner across time zones: run SME interviews, doc clinics, and content reviews with CLIENT stakeholders in New York/London; drive crisp approvals and publication cadences.
- Measure impact: define and track documentation KPIs (adoption, search success, timetoonboard, ticket deflection).
