Kamil Zwarycz

1. Documentation Engineer

   @ Adverity

   Dec 2024 – Present · Full-time (B2B)

   Multi-product SaaS data platform

   Own the documentation infrastructure and content across the product. Built the platform, built the AI layer, wrote the content.

   • Sphinx build systems

     Full configuration, custom extensions, theming, multi-version support. Migrated 800+ pages from a legacy authoring tool with a fresh content taxonomy (tutorials, how-tos, reference, concept) and no documentation incidents since cutover.

   • Search infrastructure

     Built the indexing pipeline, synonym rules, query tuning, and a zero-result analytics dashboard — measurable reduction in failed searches over the first six months.

   • Docs-as-code CI

     Linting, link validation, and OpenAPI-spec drift detection run on every PR. A diff of the new vs. previous spec opens tickets for affected docs pages automatically.

   • AI chatbot with query rewriting

     Standard RAG failed on vague, abbreviated, or product-mismatched queries. Built a query-rewriting layer: a curated terminology dictionary maps real user phrasings (wrong product names, abbreviations, conceptual descriptions) to the correct feature. Normalizes the query before retrieval — fewer 'no relevant answer' failures and less hallucination.

   • Chatbot analytics

     Captures per-interaction data: page the user was on, content visible at time of question, reading time before asking, satisfaction signals from follow-up behavior. Surfaces confusing features, high-uncertainty pages, and content gaps with no docs page.

   • Release-notes automation

     Weekly scheduled workflow. Pulls release data via REST API, filters by fix version + date, drafts the changelog with a language model, I review and publish. Replaces a multi-hour manual task with a short review cycle.

   • UX writing

     Wrote error messages, confirmation dialogs, tooltip copy, and creation-wizard copy directly with product and engineering teams.

2. Technical Writer

   @ Antmicro

   Jan 2022 – Nov 2023 · Full-time (B2B)

   Open-source embedded simulation

   Wrote and maintained the open-source simulation-framework documentation. Authored long-form engineering blog posts. Collaborated with an external partner team on CI-driven hardware testing.

   • Simulation-framework documentation (8 major sections)

     Introduction + installation, machine configuration, debugging (GDB + VS Code), execution tracing, networking (TAP/VMNET, Wireshark), host integration (UART, CAN, Arduino, VirtIO), advanced topics (HDL co-simulation, peripheral modeling), tutorials (Zephyr PTP, BLE, Verilator, USB/IP). Same doc set, two completely different audiences — beginner guides through expert HDL co-simulation.

   • CrOS EC Tester integration

     Documented the CrOS EC Tester integration with the simulation framework for CI-driven fingerprint microcontroller testing. STM32F412 (Bloonchipper) and STM32H743 (Dartmonkey) simulation — UART, GPIO, DMA, ADC, SPI, flash, MPU, FPU. Replaced physical-hardware reflashing with CI-driven simulation.

   • Bylined engineering blog posts

     Authored long-form posts on the company engineering blog. ARM architecture, FPGA/HDL co-simulation, BLE/IoT, ASIC security, Zephyr RTOS, safety-critical systems, edge AI, embedded CI/CD. Problem-solution structure with concrete tooling and reproducible steps.

3. Technical Writer

   @ Catalogic Software

   Nov 2023 – Nov 2024 · Full-time (B2B)

   Enterprise data protection

   Technical writer for three enterprise products — backup, storage, and ransomware detection. Maintained the doc set across all three product lines and shipped the platform migration to a new docs framework.

   • DPX — enterprise backup & recovery

     Installation (virtual + physical appliances for VMware / Hyper-V), full configuration / backup / recovery workflows, enterprise storage management + replication, REST API references and integration guides. Audience: IT administrators and system architects on mission-critical enterprise storage.

   • vStor — ZFS-based enterprise storage

     Installation, ZFS disks / pools / LUN volumes / compression / dedup / shares / snapshots, multipath storage, certificates, encryption URLs, MFA, CLI + REST API, security best practices (storage encryption, immutability).

   • GuardMode — ransomware detection

     Agent config via the product UI and Swagger, full REST API + Swagger docs, command-line usage, on-demand scanning, logging frameworks, FAQ / troubleshooting. Maintained docs across 5 major releases (2022.1 → 2023.2 → 2024.2 → 2024.3 → 2026.1) with OpenAPI version selectors and Git sync.

   • AI chatbot prototype (early)

     Built a prototype conversational Q&A layer over the GuardMode docs. Recognised early that docs + LLMs was high-leverage and prototyped it independently.

   • Platform migration

     Migrated all three product doc sets from their legacy system to a modern docs framework: structured content model, cross-product references, multi-version management from scratch.

• AI / Automation

  OpenAPI change monitoring in CI

  GitHub Actions runs on every PR touching the OpenAPI spec. Diffs new vs. previous spec with Python (deepdiff / openapi-diff), opens Jira tickets for each affected documentation page automatically.

  • GitHub Actions
  • Python
  • deepdiff
  • openapi-diff
  • Jira API

  • Live at docs.adverity.com↗

• AI / Automation

  Automated release notes from Jira

  Weekly scheduled GitHub Actions workflow. Pulls Jira release data via REST API, filters by fix version + date, structures into release-notes format (new features, bug fixes, breaking changes), drafts with Claude, human reviews and publishes.

  • GitHub Actions
  • Jira REST API
  • Claude
  • Python

  • Live at docs.adverity.com↗

• AI / Automation

  Claude skill authoring for docs workflows

  Writes SKILL.md files that encode documentation workflows as repeatable AI agent tasks: changelog-to-draft, cross-doc terminology consistency, bulk style-guide compliance review, structured content gap reports.

  • Claude
  • SKILL.md
  • GitHub Actions
  • Slack API

  • Live at docs.adverity.com↗

• AI / Automation

  RAG chatbot with custom query rewriting

  Standard RAG answered poorly when users used vague, abbreviated, or product-mismatched language. Built a query rewriting layer: a curated terminology dictionary maps real user phrasings to the correct product feature before retrieval.

  • RAG
  • Python
  • Vector search
  • Terminology dictionary
  • Claude

  • Live at docs.adverity.com↗

• AI / Automation

  Chatbot analytics pipeline

  Captures per-interaction data: page the user was on, exact content visible at time of question, reading time before asking, satisfaction signals from follow-up behavior.

  • Python
  • Analytics
  • Claude
  • GitHub Actions
  • Slack

  • Live at docs.adverity.com↗

• Internal tooling

  Collaborative markdown editor

  Real-time collaborative markdown editor for the Antmicro technical writing team. Multiple writers editing the same document simultaneously, no conflicts.

  • React
  • Yjs
  • WebSockets
  • CRDTs

  • Antmicro engineering blog↗

• Internal tooling

  Docs feedback overlay

  Contextual feedback tool overlaid on the internal developer docs site. Engineers highlight sections, ask questions, flag errors, and suggest improvements inline — while reading the docs in context.

  • JavaScript
  • Browser extension / overlay

  • Antmicro engineering blog↗

• Prototype

  GuardMode AI chatbot prototype

  Conversational Q&A prototype over the GuardMode ransomware-detection docs.

  • Python
  • LLM
  • Docs retrieval

  • GuardMode docs↗

• Solo product

  E-commerce platform (production)

  Complete e-commerce platform from scratch — storefront, backend, infrastructure. Solo. Live, serving real customers.

  • Next.js
  • MedusaJS
  • PostgreSQL
  • Linux VPS
  • LLM pipeline

  • Live in production (private — demo on request)↗

• Solo product

  Contractor Project Visualizer (pre-launch)

  Multi-tenant SaaS for contractors to visualize project scope and present itemized, aesthetic cost breakdowns — solving the trust gap when quoting work.

  • Next.js
  • TypeScript
  • Zero-cache
  • Stripe
  • PostgreSQL

  • In final pre-launch testing (private — demo on request)↗

Selected long-form writing and docs I worked on. Four pieces that show the range — embedded CI testing, CPU RTL co-simulation, BLE, and pre-silicon ASIC work. The doc sites are live links to the surfaces I maintained.