Документация как комиксы
Когда мне было четыре или пять лет, мама подарила мне книжку комиксов «Откуда берутся дети». Я прочитал, всё понял и в следующие лет 7-10 знал точно больше своих сверстников. Конечно, потом были и другие источники, но тот комикс дал мне начальные знания и избавил от кучи недоразумений.
Теперь мне уже гораздо больше годиков, но за последний месяц я с удовольствием прочитал целых три комикса:
— «Приятного плавания с Kubernetes».
Древнегреческий мореплаватель Ясон теперь работает в IT и руководит отрядом боевых админов. Это сложнее, чем засевать поля драконьими зубами. Богиня Гера знакомит его с «κυβερνήτης», «рулевым». Конечно, Рулевой решает сразу все проблемы Ясона — это же сказка, а в сказке так бывает.
— Как работает DNS.
DNS-запрос путешествует в поисках IP-адреса.
— Как работает HTTPS.
Сертификот и другие звери рассказывают о том, как защитить сообщения в интернете от злонамеренных крабов.
---
Кстати, от того же корня, что и «кубернетес», образованы слова «губернатор» и «гувернёр».
Знаете другие примеры хорошей документации в картинках? Приходите обсудить их в @docsascode.
Когда мне было четыре или пять лет, мама подарила мне книжку комиксов «Откуда берутся дети». Я прочитал, всё понял и в следующие лет 7-10 знал точно больше своих сверстников. Конечно, потом были и другие источники, но тот комикс дал мне начальные знания и избавил от кучи недоразумений.
Теперь мне уже гораздо больше годиков, но за последний месяц я с удовольствием прочитал целых три комикса:
— «Приятного плавания с Kubernetes».
Древнегреческий мореплаватель Ясон теперь работает в IT и руководит отрядом боевых админов. Это сложнее, чем засевать поля драконьими зубами. Богиня Гера знакомит его с «κυβερνήτης», «рулевым». Конечно, Рулевой решает сразу все проблемы Ясона — это же сказка, а в сказке так бывает.
— Как работает DNS.
DNS-запрос путешествует в поисках IP-адреса.
— Как работает HTTPS.
Сертификот и другие звери рассказывают о том, как защитить сообщения в интернете от злонамеренных крабов.
---
Кстати, от того же корня, что и «кубернетес», образованы слова «губернатор» и «гувернёр».
Знаете другие примеры хорошей документации в картинках? Приходите обсудить их в @docsascode.