Spolupráce¶
Většina týmů nemá problém s psaním. Má problém se strukturou.
Obsah existuje — v hlavách, ve Slack vláknech, v napůl hotových Confluence stránkách, v institucionální paměti toho jednoho člověka, který je tu dost dlouho, aby si pamatoval, proč se rozhodlo jak. Nikdo ale nepostavil systém, který to celé zpřehlední, udrží aktuální a bezpečně předá novému člověku.
To je problém, který řeším.
Co vlastně dělám¶
Navrhuji dokumentační systémy. Ne dokumenty — systémy.
To znamená informační architekturu, schéma obsahu, jediný zdroj pravdy, výběr nástrojů, mapování person a model údržby — to vše dřív, než se napíše jediné slovo obsahu. Psaní přichází po struktuře. V tomto pořadí, ne obráceně.
Specializuji se na MkDocs Material jako publikační vrstvu. Postavil jsem na něm produkční dokumentační systém — plnohodnotný CCMS se schématem obsahu, uzavřenými slovníky tagů a automatizovaným publikačním pipeline. Vím, kde funguje, kde ne, a co tým potřebuje, aby ho správně přijal — ne jen nakonfiguroval téma.
Upřímná hranice¶
Navrhuji a stavím dokumentační systémy. Nejsem infrastrukturní inženýr. Když se rozbije pipeline, to není má odpovědnost ani znalost — a řeknu vám to jasně před zahájením spolupráce, ne až potom, co něco přestane fungovat.
Správná zakázka má technického spoluřešitele pro implementaci, nebo jasně definovaný rozsah, který infrastrukturu nechává mimo smlouvu. Obojí takto může fungovat. Rovnou se zbavme nejasností.
Jak spolupráce probíhá¶
Typická zakázka začíná auditem. Přečtu, co existuje, identifikuji strukturální problémy a navrhnu architekturu ještě předtím, než napíšu první slovo. Pak stavím — zpravidla nejprve dokumentační framework, pak obsah v pořadí priorit, s průběžnými revizemi.
Pracuji vzdáleně, na projektovém základě. Jsem jeden člověk — žádní account manažeři, žádní juniorní autoři produkující obsah, který pak musím opravovat, žádné agenturní náklady. To také znamená, že mám omezenou kapacitu a vybírám projekty, kde se vyplatí předmět dobře pochopit.
Sazby a časové rámce závisí na rozsahu. Nejlepší začátek je krátký e-mail popisující, co potřebujete vyřešit.
Co nedělám¶
Ghostwriting pro lidi, kteří chtějí uznání bez práce. Dokumentaci jako přílepek na hotový produkt. „Jen to pěkně upravte." Implementaci infrastruktury a správu pipeline.
Dobrá dokumentace se navrhuje předtím, než se píše. Pokud potřebujete někoho, kdo vyleští existující obsah, pravděpodobně nejsem ten správný. Pokud potřebujete někoho, kdo postaví architekturu a pak ji naplní, ok!
Pro koho to je¶
- Projekty otevřeného hardware a open source, které potřebují dokumentaci dostatečně seriózní, aby přilákala přispěvatele a institucionální zájem.
- Inženýrské týmy, které vydávají dobré produkty s příšernou dokumentací a vědí o tom.
- Startupy, které potřebují svůj interní knowledge management zpřehlednit, než odejde s člověkem, který ho drží v hlavě.
- Organizace zvažující MkDocs Material, které ho chtějí dobře nasadit — architektura jako první krok, ne téma.
Portfolio¶
Přečtěte si to. To je moje práce. Pokud to je standard, který vám vyhovuje, tak bychom si mohli rozumět.
Kontakt¶
Žádné formuláře. Žádné discovery cally, pokud je nechcete. Email stačí.