Hallo! Ich bin Katya, die Leiterin des technischen Redaktionsteams bei Ozon. Jetzt haben wir 9 Mitarbeiter und eine ganze Plattform fĂĽr Dokumentation, aber die Kollegen verstehen immer noch nicht immer, was wir tun.
Aus Missverständnissen erscheinen Anfragen des Formulars: "Wir wollen unseren eigenen technischen Redakteur für das Team, aber wir wissen nicht, was er genau tun wird." Infolgedessen passt sich das Team den Trends an und erstellt eine Dokumentation für sich selbst. Nach einigen Monaten stellt sich jedoch heraus, dass das Dock nicht gelesen wird und der technische Redakteur sich reibungslos in einen Analysten verwandelt hat.
Daher ist es Zeit, Erfahrungen auszutauschen und ĂĽber einige konzeptionelle Dinge zu sprechen :)
Wer sind ĂĽberhaupt Tech-Autoren?
Ich habe verschiedene Antworten gefunden, von "Leuten, die unnötige Talmuds nach GOSTs schreiben" bis zu Definitionen, die meiner Realität ziemlich nahe kommen.
Bei Ozon arbeiten technische Redakteure weltweit in drei Bereichen:
Benutzerdokumentation (Hilfe, Knowledge Base, FAQ),
externe API-Dokumentation,
Beschreibung interner Systeme - vom Onboarding bis hin zu komplexen architektonischen Interaktionen.
"" — — Ozon , . , , .
— , , . , , , .
, , , .
, - . API — " - ".
, ?
, - — . "" . , , , .
:
— .
- , — , " " " ".
- — , - — , . : ", , ", , .
— , . , , . .
?
, .
- . ( ) ; , , 24/7 — . - , — .
, — , . , , — , IT.
, - . , , . , , , . , , 10 .
?
. , , — , , - . — , .
:
.
, . , , .
, — .
- .
— - .
. , — - . , .
— . , : , . — , , .
, , , - , . " , " — , , , .
: 1.5 . — , - .
:
, , :
? , ?
? ? , - YouTube?
, ? , , URL ?
, ? ? ?
, . .
?
— , , .
, , ​:)