Из интересного: https://ru.wikipedia.org/wiki/%D0%94%D0%A0%D0%90%D0%9A%D0%9E%D0%9D?oldformat=true

ну дракон это давняя тема, на нее можно через 1с выйти или алгол или еще какой-то

Ну я ж написал не свежая новая тема, а интересная

Хороший пример подачи документации в IKEA-стиле, в виде картинок/комиксов https://code-cartoons.com/

Кстати, я видел эти штуки, но кажется они мне показались слишком сложными для моего уровня.

То есть они предполагают, что я уже фронтендер со стажем. А я не фронтендер.

Документация как комиксы

Когда мне было четыре или пять лет, мама подарила мне книжку комиксов «Откуда берутся дети». Я прочитал, всё понял и в следующие лет 7-10 знал точно больше своих сверстников. Конечно, потом были и другие источники, но тот комикс дал мне начальные знания и избавил от кучи недоразумений.

Теперь мне уже гораздо больше годиков, но за последний месяц я с удовольствием прочитал целых три комикса:

— «Приятного плавания с Kubernetes».  
Древнегреческий мореплаватель Ясон теперь работает в IT и руководит отрядом боевых админов. Это сложнее, чем засевать поля драконьими зубами. Богиня Гера знакомит его с «κυβερνήτης», «рулевым». Конечно, Рулевой решает сразу все проблемы Ясона — это же сказка, а в сказке так бывает.

— Как работает DNS.  
DNS-запрос путешествует в поисках IP-адреса.

— Как работает HTTPS.  
Сертификот и другие звери рассказывают о том, как защитить сообщения в интернете от злонамеренных крабов.

---

Кстати, от того же корня, что и «кубернетес», образованы слова «губернатор» и «гувернёр».

Знаете другие примеры хорошей документации в картинках? Приходите обсудить их в @docascode.

О, я помню эту чудесную книгу. Тоже будоражила мой неокрепший пятилетний ум.

В пятом классе мы с другом спорили об анатомии девочек и почти подрались.

И еще была недавно в блоге у фаерфокс отличнейшая статья с отличными пояснениями всякого, но уже 10 минут ищу и не могу найти, бросаю попытки и иду на перекур

я ее первый раз лет в 13 увидел, на тот момент уже познакомившись с более приближенной к реальности другой книжкой для подростков но все равно было удивительна подобная подача материала для детей

В этих вопросах я придерживаюсь мнения, что ребёнку нужно рассказывать все как есть - но не давать больше, чем он спрашивает. Но если ребёнок очень любопытный - этакий почемучка - такой комикс хорош

С программистами думаю надо так же 😹

https://hacks.mozilla.org/2017/08/inside-a-super-fast-css-engine-quantum-css-aka-stylo/
https://hacks.mozilla.org/2017/06/a-cartoon-intro-to-arraybuffers-and-sharedarraybuffers/

Не находил т.к это комиксы от тех же кто делает Code Cartoons, но для Мозиллы

https://twitter.com/codecartoons

> Nick Volynkin, a technical writer at Plesk, makes these excellent points while advocating for project wiki use in a docs-like-code environment.

Дайте угадаю, это Docs like code, второе издание?

Из Docs like code by Anne Gentle ;)

крутяк, мы с ней переписывались немного

я пока не читал новое издание )))