# Ruslan Kotowski **Senior Technical Writer & Docs Engineer** · Amsterdam, Netherlands [kotowski.ruslan@gmail.com](mailto:kotowski.ruslan@gmail.com) · [+31 68 758 43 50](tel:+31687584350) · [LinkedIn](https://www.linkedin.com/in/ruslankotowski/) Senior Technical Writer with 13 years in software documentation: API references, developer portals, and the systems that publish them. At [Miro](https://miro.com/), I lead the Help Center's move to docs-as-code. Nearly 1,000 articles are now written in Git, checked and published by a pipeline I built, and readable by AI agents as well as people. Based in Amsterdam, open to remote work. ## Experience ### Senior Technical Writer · [Miro](https://miro.com/) _Nov 2023 – Present_ I lead the Help Center's move to docs-as-code: I pitched it and own it, and I built most of the tooling with AI coding agents. It's my second complete docs-as-code migration, after WorkFusion. - Moved nearly 1,000 English articles out of Zendesk's editor and into Git. - Built the pipeline in Python and GitHub Actions. It covers publishing (hierarchy, ordering, audience permissions, HTML cleanup) and a round-trip check that nothing is lost between Markdown and HTML. - Wrote the AI tooling for the writing team: 8 reusable agent skills (scaffold, move and retire articles; formatting and pre-publish checks) and a shared AGENTS.md, so Claude Code, Cursor and Codex all follow the same authoring rules. - Wrote the authoring standard and a Git guide for writers, and review most contributors' pull requests (56 of 78 so far). Engineers now open doc fixes as PRs too. - Added checks to every pull request: front matter, links, Vale style rules, spelling, and audience gating. That's 20+ CI workflows and 100+ test files. - Made the Help Center readable for AI agents with llms.txt and per-area Markdown bundles built from the same source. - Linked every article to the engineering team that owns its feature in the service catalog, so outdated docs have a named owner. - Led the redesign of the Help Center's Zendesk Guide theme, live since October 2026: full navigation, ⌘K search, dark mode and a Copy page menu for AI tools. - Wrote API documentation and developer onboarding guides for the Miro Developer Platform with 15+ engineering teams. ### Technical Writer · [Adyen](https://www.adyen.com/) _Aug 2020 – Oct 2023_ Wrote and maintained developer documentation for Adyen's payment products: API references for 200+ endpoints, authentication flows, and integration guides. Worked with product teams to keep the docs in step with releases. ### Technical Writer · [WorkFusion](https://www.workfusion.com/) _May 2018 – Apr 2020_ Owned documentation for WorkFusion's AI and automation platforms. Led the move to docs-as-code and migrated 500+ articles into Git-based workflows. ### Technical Writer · [Wargaming.net](https://wargaming.net/) _Sep 2015 – May 2018_ Wrote technical documentation for Wargaming's games and platforms, used by 100+ developers, managers, and third-party publishers. Set up content delivery for external developer partners across 12 markets. ### Technical Writer / Business Analyst · [Wargaming.net](https://wargaming.net/) _May 2013 – Sep 2015_ Documented game platforms and digital stores. Coordinated localization across 8 markets and wrote content for global game launches. ## Selected work - [Moving a 1,000-article Help Center to docs-as-code](https://kotowski.me/work/help-center-docs-as-code.html) — How I moved Miro's Help Center out of Zendesk's editor and into Git, and switched publishing over without readers noticing. - [Redesigning the Miro Help Center](https://kotowski.me/work/help-center-redesign.html) — How I rebuilt the Help Center's Zendesk theme so readers find answers faster, in their own language, and can hand any article to an AI assistant. ## Skills - **Documentation:** API references and guides · Content standards and PR review · Information architecture · Localization workflows - **Docs-as-code:** Markdown, Git and GitHub · GitHub Actions CI/CD · Vale, Docusaurus, Zendesk Guide · Python automation - **AI and web:** Agent skills and prompts (Claude Code, Cursor) · llms.txt and AI-readable docs · JavaScript code samples, HTML/CSS · REST APIs --- Updated October 2026 · Web: · PDF: