Мир глазами другого человека
7.25K subscribers
9 photos
1 video
3 files
218 links
Лонгриды про людей и управление командами. Закреп. @dumtest aka Роман Ивлиев. CTO, CPO TeamLead Conf. AdsFree. 18+. @ask_roman_bot
Download Telegram
Forwarded from CatOps
Сага в четырёх частях от СЕО Percona Петра Зайцева о мониторинге производительности в Linux и типичных ошибках:

- Часть первая: CPU
- Часть вторая: Disk
- Часть третья: Memory
- Часть четвёртая: Network

Очень хороший разбор, рекомендую к прочтению 👍

#observability
Forwarded from Technical Writing 101 🇺🇦 (Нац Нац)
Очень (очень!) хорошая статья от Nuclino о том, почему никто не читает документацию, почему это нормально и варианты разрешения этой ситуации. Nuclino сами занимаются разботкой софта для Обмена Знаниями, такой себе аналог Notion, поэтому они знают о чем говорят.

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

Ключевые моментики из статьи:

- Никто не читает документацию и это ОК
- Документация нужна не чтобы её читать, а чтобы с ней консультироваться
- Не пишите документацию, только ради написания. Никому не нужен огромный, толстый, пускай и всеобъемлющий кусок текста
- Пишите документацию держа в голове то, что скорее всего, её будут искать в поиске, а не просматривать все оглавления
- Пишите небольшие кусочки документации и пользуйтесь кросс-ссылками, ссылаясь на другие, такие же небольшие кусочки док.

Бонусный трек: их же статья про ценность документации и сколько может стоить отказ от обмена знаниями.
Я тут решил начать пересказывать в разных местах тимлидконф своими словами - https://g-mate.timepad.ru/event/1472018/ Только ленивый про это ещё не говорил, пришла моя очередь. Точнее я про это тоже говорил в Воронеже года два назад, но записи с GDG нет в открытом доступе, поэтому не считается.