Владимир Обризан: персональный сайт - 07

Мне нравится читать документацию

2026-08-07T16:02:50+03:00

Я читал документацию на этой неделе. И на прошлой неделе тоже. И на следующей неделе тоже буду читать документацию. Мне нравится читать документацию.

Зачем мне тратить время на то, чтобы писать ИИ, ждать "thinking longer for the better answer"™, если я могу просто загуглить нужную документацию, открыть её и наслаждаться неспешным чтением от начала до конца? Обратите внимание: ИИ не может дословно воспроизводить защищённые авторским правом материалы — ему приходится их перефразировать. Так зачем читать перефразированный ИИ текст, если можно прочитать настоящий первоисточник в оригинале?

Образовательный кризис

2018-03-07T10:04:00+02:00

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

В один из дней участник чата выложил фотографию теоретических задач, которые ему выдали на собеседовании. Среди прочих задач и вопросов были такие: "Сколько бит в байте? Переведите число из десятичной системы в шестнадцатеричную. Посчитайте количество бит в числе". Меня удивила реакция начинающих программистов:

— Ха-ха-ха! Где это в реальных проектах нужно считать количество бит в байте?
— Пффф... Что за идиотские задания, зачем это нужно фронтендщику?

Драма разыгралась уже на следующий день. Один из участников чата обратился за помощью с такой вот проблемой:

— Спасите! Помогите! Складываю 0,1 и 0,2 и в результате получаю не 0,3, а 0,30000000000000004!

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

Современные компьютеры — дискретные. Числа хранятся как целые и вещественные. Вещественные хранятся в формате с фиксированной точкой или в формате с плавающей точкой. Основная особенность, что вес каждого разряда: кратный двойке. Для целых чисел это 2⁰, 2¹, 2², 2³ и так далее. А для дробей то же самое, но в знаменателе: 2⁻¹, 2⁻², 2⁻³ и так далее. Т. е. 0,5, 0,25, 0,125 и так далее. Если у нас на дробную часть отводится два двоичных знака, то мы можем записать числа кратные 0,25: 0, 0,25, 0,5, 0,75, 1 и так далее. Но с такой разрядной сеткой не получится записать ни 0,2, ни 0,1 ни 0,3.

А сколько еще разных курсов и дисциплин, которые игнорируются современным обществом программистов? Дискретная математика, алгебра, высшая математика, теория графов, теория вероятности, статистика, структуры данных и алгоритмы, объектно-ориентированное программирование, системы управления базами данных, системотехника, теория информации и кодирования, математическое моделирования и так далее до полных четырех лет бакалаврата.

Геополитический кризис привел к экономическому кризису. Экономический привел к культурному. Культурный привел к образовательному. Образовательный привел к профессиональному. Профессиональный ведет к промышленному кризису.

Откровения Божьи и программисты

2017-04-07T23:27:00+03:00

Программисты обожают Откровения Божьи. Это когда всем очевидна какая-то истина, а программисты к ней приходят долгими пространными рассуждениями.

Сегодня прочитал статью "TDD Harms Architecture". (http://blog.cleancoder.com/uncle-bob/2017/03/03/TDD-Harms-Architecture.html). Статья о том, что мол культура автоматического тестирования вредит архитектуре программы. После долгих пространных рассуждений автор заканчивает пятью абзацами текста про то, что это программисты делают плохую архитектуру, а не тесты.

Очередной программист выдал Откровения Божьи. Для меня это так же смешно, как и надпись на костюме супермена: "Не дает способность летать".

Анекдот менеджерам проектов

2016-10-07T00:18:00+03:00

Дайте расскажу вам анекдот. Пятеро программистов сидят поздно вечером в воскресенье 31 декабря на работе и гадают: каким хуем их туда занесло. "Что мы сделали не так? Где ошиблись? Чего не сделали?" Ищут виноватых и прочая херня. И вдруг один говорит:

— Погодите... Когда мы планировали проект, мы просто сидели и рассказывали блять анекдоты.

Личная эффективность: список задач

2016-02-07T23:00:00+02:00

Часто граждане интересуются: как лично я организую свою работу. Для личной эффективности использую много инструментов. Сегодня поговорим о списке задач.

Список задач — самый важный инструмент для организации личной эффективности. В список задач выгружаются из головы абсолютно все дела, которые нужно сделать. Список делится на "проекты", например: "Работа", "Университет", "Дом" и так далее. А также задачи делятся на "Сделать сегодня", "Сделать на неделе", "Сделать потом".

Самое важное условие — выгрузить абсолютно все, что есть в голове. От элементарных вещей, до сложных. Нельзя поддаваться на искушение "та я это и так запомню и сделаю". Такие вещи в 95% забываются и не делаются.

Для ведения задач рекомендую "Микромили": http://micromiles.co/

Список задач на день и на неделю нужно пересматривать ежедневно, перекладывая задачи, если потребуется. Список задач на неделю и на потом нужно пересматривать раз в неделю и тоже перекладывать, если нужно.

В результате голова будет полностью освобождена от необходимости помнить, что нужно сделать, и все внимание будет уделено только тем задачам, которые нужно сделать сегодня. Со списком задач невозможно что-то забыть. Можно сознательно не сделать, но забыть — невозможно.

Помню, когда первый раз выписал все задачи из головы в программу, то почувствовал небывалое облегчение. Оказалось, что да, важных задач очень много, но именно на сегодня их было буквально две и обе из них я уже решил и волноваться уже не нужно. Это было счастьем.

Более подробно о методе доведения дел до конца можно посмотреть у Максима Дорофеева: http://mnogosdelal.ru/slidecasts/dovedenie-del-do-kontsa/

Как люди живут без списка задач — я не знаю. Строго рекомендую завести.

Обесцененные ценности

2014-09-07T01:38:00+03:00

Летом 2004 года близкий друг (Саша, привет!) пригласил сходить на вечернюю проповедь в зал царства Свидетелей Иеговы. Чем меня могло заинтересовать приглашение близкого друга сходить на вечернюю проповедь в зал царства Свидетелей Иеговы? Тем, что проповедник был из США, а американские проповедники рассказывают интересно, убедительно, да и хотелось послушать речь носителя второго родного языка. Проповедь заняла около 40-50 минут, я почти что ничего не помню, кроме названия: "Обесцененные ценности" и сути, отражающей это название. Смысл примерно следующий: Господь Бог создал заповеди, которые мы должны соблюдать. Некоторые люди принимают решение, что какие-то заповеди нужно соблюдать, а какие-то заповеди не нужно, и таким образом обесценивают заветы Бога.

И я запомнил такой жест проповедника: правой рукой он провел черту в воздухе параллельно земле на уровне головы и сказал: "Вот такими вас хочет видеть Бог". А левой рукой провел черту на уровне груди и сказал: "А вот такими вы хотите видеть сами себя. Вы обесценили ценности". Тогда мне это показалось просто забавным, не более того. Но спустя несколько лет я столкнулся с обесцененными ценностями в сфере образования.

Что является ценностью в образовании? Полученные знания. Что мы сейчас наблюдаем в вузе: студенты в одностороннем порядке понижают академические нормы. Сразу оговорю, что нормой я считаю отличное знание предмета: на 90-100 баллов. Кроме академических норм существуют еще профессиональные нормы на рынке труда, они конечно же выше академических норм, но т. к. они прямо пропорциональны, то занижая одну норму, понижается и другая.

Во времена эпохи Возрождения объемы знаний (а значит и нормы) повышались. Вспомните бессмертное у Исаака Ньютона: “Если я и видел дальше, то только потому что стоял на плечах гигантов”. Здесь имеется в виду, что на основании знаний предыдущих поколений удалось получить новое знание, передать его потомкам. Сейчас же происходит обратный процесс: некоторые студенты самостоятельно понижают норму знания до посредственного уровня. Некоторые студенты пытаются просто сдавать предмет вовремя, на "абы как". Связано это с тем, что сессия спланирована заранее, время ограничено, да и знания — не ахти какая ценность. И если до экзамена осталась одна ночь, и дату экзамена передвинуть невозможно, то оставшийся свободный параметр — это качество (объем) знания. Разумеется, что такие знания вылетят из головы быстрее, чем преподаватель успеет закрыть зачетку после экзамена.

Можно выделить несколько характерных порогов:

— 60 баллов — проходной балл, меньше нельзя, уже будет "двойка" и не переведут в следующий семестр;
— 75 баллов — средний балл для получения стипендии.

Похожая ситуация возникает с предметами, на которых нет экзамена, а есть зачет — там достаточно получить "тройку", чтобы перевестись дальше.

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

Сайт ХНУРЭ продолжает удивлять

2014-06-07T11:16:00+03:00

5 августа 2012 года я написал заметку "Сайт ХНУРЭ 20х2 года".

В 2013 году дизайн сайта все-таки сменили. Но редакторская политика осталась старая.

Спасибо за приглашение, но, увы, машиной времени обладает не каждый.

Вспомнить все

2014-02-07T00:22:00+02:00

Еще в полдень четверга ничто не предвещало беды. Но уже в 16:00 раздался первый тревожный звоночек с неизвестного номера:

— Привет, ну ты завтра будешь?

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

— Да, конечно буду, как обычно. А ты, что ли, номер поменял?
— Нет.
— Странно, он у меня не определился.

Второй тревожный звоночек прозвенел позже, через несколько часов, когда в "Вибере" вместо имен и фамилий были показаны просто телефонные номера.

Тут и к Стиву Джобсу не ходи — у меня слетела телефонная книга.

649 контактов, которые собирались на протяжении 10 лет, телефонные номера людей, которым я звонил или кто мне звонил хотя бы один раз, — все исчезли в неизвестном направлении. А затем подтвердился еще более печальный факт: пропали не просто контакты, а все данные, связанные с Айклаудом — эпловской облачной платформой. Например, вот так выглядит список заметок, где я собираю разные мысли, идеи, полезные ссылки:

Также был пуст и календарь. Девственно чист был список задач.

Мне стало интересно, сколько телефонных номеров я помню и без адресной книги? Насчитал пять штук, среди которых три оказались бесполезными: рабочий телефон, телефон на кафедре и телефон МКС.

Потом в голову пришла другая мысль: а может не париться и не восстанавливать телефонную книгу? Может не нужны мне эти 649 номеров? Кто все эти люди? Может, кому нужно, тот сам позвонит или смску напишет?

Последняя мысль была о том, что мне на самом деле все равно, сколько номеров в телефонной книге: ну ноль, так ноль.

А вечером я перезагрузил телефон, он попыхтел минутку, скачал все данные из облака, и все стало на свои места.

Death — Symbolic

2011-10-07T09:29:00+03:00

Чак Шульдинер — серебрянный голос death-металла.

Death — Symbolic на Яндекс.Музыке

Новости цивилизованной эуропы

2010-11-07T08:59:00+02:00

Корреспондент из Праги сообщает:

С 1 января гражданам Чехии разрешается иметь при себе: до 15 граммов марихуаны, до четырех таблеток экстази, двух граммов амфетамина, полтора грамма героина, один грамм кокаина. Разрешается также выращивать в домашних условиях до пяти кустов конопли и 40 галлюциногенных грибов. Уголовное наказание за хранение вышеприведенной количества наркотических средств отменен.

В Чехии легализовали наркотики

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

О дизайне в документации разработчика

2010-08-07T18:39:00+03:00

Долго не мог понять в чем проблема, но только что разобрался и тороплюсь доложить вам. Заметил, что читая документацию в MSDN’е на душе становится как-то хорошо и спокойно, а когда читаю в doxygen’е, то как-то подташнивает.

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

Так вот, если меня интересует какой-либо класс из библиотеки .NET, то в MSDN’е описание выглядит так:

Здесь четко видно: секция «конструкторы» — один метод, секция «методы» — пять. Плотность подачи информации равна шести единицам. Давайте посмотрим на документацию в дефолтовом стиле doxygen’а:

Секции всё также видны, но так легко считать отдельные методы уже не получается. Визуально толстые синие ссылки доминируют над декларациями методов, и отвлекают внимание. Более того, на одном экране мы видим описание только трёх методов. Значит условная плотность равна трём.

Обратите внимание, как doxygen заботливо тип «unsigned» сделал ссылкой. Если вы забудете, что такое unsigned, то вы всегда сможете пройти по ссылке и узнать.

Важная часть документации — это не только описание, но и примеры исходного кода. В MSDN’е мы видим исходники в таком оформлении:

Раз, два, три, четыре — и всё. Четыре цвета. Исходный код в doxygen’е выглядит так:

Здесь же мы видим такие классы подсветки: 1) директивы; 2) ссылки; 3) ключевые слова раз; 4) ключевые слова два; 5) комментарии; 6) встроенные типы; 7) идентификаторы, пунктуация. Итого семь разных цветов. Понятно, что подкраска — это дело вкуса, но если пользователь и так знает, что на любой идентификатор можно кликнуть и перейти в место определения, то зачем лишний раз выделять ссылки синим цветом?

Ну и на последок уменьшенная в пять раз collaboration diagram из doxygen’а. Реально кто-то будет ей пользоваться будучи в реальном размере (3600 на 1500 пикселей, смотреть оригинал)?

В комментариях приветствуются ссылки на мануалы и личный опыт ведения документации, настройки doxygen’а и прочее.