Docs-as-CodeTechnical WritingOpenAPISphinxProcess Design

    Building a Documentation Pipeline for a Biometric Software Suite

    Building a Documentation Pipeline for a Biometric Software Suite

    1,000+

    Pages

    11

    Products

    50+

    Training hours

    100+

    People onboarded

    Company

    Griaule — Campinas, SP, Brazil

    Role

    Product Manager & Technical Writing Manager

    Period

    July 2019 – August 2023

    The Situation

    Griaule had no centralized documentation system. Technical knowledge lived in scattered Google Docs owned by different people — incomplete, inconsistent, and updated only on demand, with delays of weeks or months. As the product portfolio grew to 11 products, including 7 desktop-to-web application migrations happening simultaneously, this became unsustainable.

    What I Did

    I designed and built a Docs-as-Code pipeline using Sphinx, reStructuredText, and Git Hooks — integrating it into the company's version control and deployment workflow so that documentation updates deployed automatically, continuously, and without manual intervention. I then authored 1,000+ pages of technical content and API references (OpenAPI/Swagger) across the full product suite, managing the documentation lifecycle in parallel with active product development and QA. I also built the company's e-learning infrastructure: 50+ hours of technical training content covering onboarding, product usage, and client education — content that has reached 100+ people and remains in active use today.

    The Outcomes

    • Documentation went from weeks/months of update delay to continuous, always-current deployment • 1,000+ pages maintained across 11 products simultaneously • Federal Government agency (the company's largest client) directly cited documentation quality in a contract renewal meeting — contributing to continuation and an estimated 10–20% reduction in documentation-related support tickets • 100+ employees and external clients onboarded through the training library