João Peixe
Technical Writer | Knowledge Systems & Structured Documentation · AI Tooling
I believe the most expensive thing in any institution is knowledge that cannot be accessed. I build documentation systems that make complicated environments legible at scale.
- location:
- Guimarães, Portugal
- work:
- relocate · hybrid · remote
- education:
- BA Portuguese & Lusophone Studies — Universidade do Minho
- status:
- Open to opportunities
- tags:
- [documentation, docs-as-code, ai-assisted-workflows, tooling-ai-assisted]
Overview
As a linguist, I’m trained to turn complexity into structure and carried that instinct into seven years of freelance language work where correctness and deadlines were the entire job. Teaching university students and coaching youth volleyball added something else: communication does not happen if the receiver does not understand the message. No matter how well I deliver my message, if my audience does not get it, I didn’t communicate. None of this was a detour. Everything converged when I walked into Eurotux and found an engineering company with fifty specialists and no structured documentation.
Over three and a half years, I built a library of more than 1,000 SOPs from scattered knowledge and through interviews with SMEs. As the library grew, on-time ticket resolution rose from 36% to 53%. Over time, I earned the technicians’ confidence and changed the culture to the point where they proactively contributed drafts and signalled procedures that needed updates. At the same time, I produced over 150 installation reports. For those, I introduced version-controlled Docs-as-Code workflows and, more recently, designed AI pipelines that cut report-drafting time in half.
I build what I need. No, I cannot code. But building documentation comes from research and understanding the systems being documented, and that enabled me to build. That instinct means that I don’t stand still waiting for tooling to appear. I’m someone who designs the knowledge infrastructure, not just the articles inside it.
Case studies
What I built, what it solved, and what it proved.
- 2.1
The SOP Transformation
From scattered knowledge to 1,000+ structured proceduresHow an IT services company with no centralised documentation ended up with a structured knowledge base used daily by 50+ engineers.
- 2.2
SOP Library PoC
Schema-governed procedure libraryA proof of concept addressing the wiki's lack of field enforcement and post-approval integrity through XML Schema-governed structured authoring.
- 2.3
VB Manager
Full-stack volleyball management platformA coaching problem that became a full-stack application, self-hosted on a Proxmox homelab and built entirely with AI.
Capabilities
- 3.1Documentation
- Technical writingInformation architectureStructured metadataTemplatingStyle guidesEditorial reviewStructured authoring
- 3.2Docs-as-code
- GitMarkdownLaTeXXML / XML SchemaDoc pipelinesXWikiLinux
- 3.3AI-assisted workflows
- Claude / Claude CodeGPT modelsGemini CLIMulti-agent pipelines
- 3.4Tooling (AI-assisted)
- PythonStreamlitShellDockerProxmoxTerraformAnsible
Engagement log
- 4.1Feb 2023 – Jun 2026
Technical Writer
Eurotux, S.A.- Built 1,000+ SOPs for 50+ engineers across 6 technical teams, consolidating scattered documentation into structured procedures with variable-driven templates and consistent time-to-resolve estimates. On-time ticket resolution rose from 36% to 53% as the library expanded.
- Captured tacit knowledge from 50+ engineers by embedding with the teams. Shifted the culture from no structured documentation practice to senior technicians proactively submitting drafts.
- Reduced report drafting time by 50% with multi-agent LLM pipelines (GPT, Claude) that automated translation, formatting, and data extraction from internal systems.
- Wrote 150+ LaTeX implementation reports and manuals, version-controlled through a Git-based Docs-as-Code pipeline with change tracking and code-level review.
- Proposed an XML/Schema architecture to replace the wiki-based SOP system, addressing field enforcement and post-approval integrity gaps. Built the proof of concept independently.
- 4.2Jan 2015 – Jan 2023
Freelance Language Professional
Remote- Delivered bilingual content (Portuguese and English) for international clients over 7 years, managing concurrent projects and overlapping deadlines independently.
- Built reusable templates and glossaries for recurring clients, reducing turnaround time and ensuring terminology consistency across projects.
Contact
Let's talk
Looking for a role where documentation is infrastructure, not an afterthought. Open to remote and international opportunities.