• Как мы считаем метрики разработки и поддержки документации. Доклад Яндекса

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



      Рассказывает Юрий Никулин, руководитель службы разработки технической документации.


      Для начала давайте определим, что такое производительность. В классическом понимании, это время на производство единицы продукции или количество продукции, произведенное в единицу времени.


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


      Читать дальше →
      • +16
      • 5.9k
      • 2
    • Исследования показывают: люди, у которых «чересчур много интересов» имеют больше шансов на успех

      • Translation


      Самый исчерпывающий кейс, объясняющий, почему в современной «экономике знаний» почти каждый должен стать энциклопедистом.

      «Мастер на все руки, а толком ничего не умеет».

      Предостережение против универсализма сохранилось в многовековой истории десятков языков. «У него каких только ножей нет — и ни одного острого», — предупреждают китайцы. А в Эстонии есть поговорка «девять ремесел, и голод — десятое».

      Однако, многие из наиболее неординарных личностей — как живших в прошлом, так и наших современников — были универсалами: таковы Илон Маск, Стив Джобс, Ричард Фейнман, Бенджамин Франклин, Томас Эдисон, Леонардо да Винчи и Мария Кюри — список далеко не полон.

      В чем же здесь дело?

      Если попытка универсализма — путь к посредственности, то почему наиболее исчерпывающее исследование о самых видных ученых в истории показало, что 15 из 20 были энциклопедистами? Ньютон. Галилей. Аристотель. Кеплер. Декарт. Гюйгенс. Лаплас. Фарадей. Пастер. Птолемей. Гук. Лейбниц. Эйлер. Дарвин. Максвелл — все энциклопедисты.

      Если пытаться делать все сразу так неэффективно, то почему основатели пяти крупнейших компаний в мире – Билл Гейтс, Стив Джобс, Уоррен Баффетт, Ларри Пейдж и Джефф Безос – все энциклопедисты (а также придерживаются «правила пяти часов»)? Эти легендарные люди – просто гениальные исключения? Либо это люди, которым мы могли бы (и должны) подражать, чтобы достичь успеха в современной «экономике знаний»?

      Если стремление к универсализму – неэффективная карьерная стратегия, то почему более 10 академических исследований выявили корреляцию между количеством интересов/компетенций, которые удалось развить человеку, и его творческим потенциалом?

      Переведено в Alconost
      Читать дальше →
    • Тестирование документации к программным продуктам

      Когда-то в стародавние времена была у меня задача по тестированию документации к нескольким программным продуктам. Пользуясь гуглом, не удалось отыскать на раз-два информацию о том, какими качествами должна обладать документация и кому она нужна. Собирал все по крупицам. Давно принял решение написать об этом, и вот, пользуясь наличием праздничных дней, публикую.
      Читать дальше →
    • Играючи BASH'им

      Как я написал игру на bash'е.

      image

      Нетерпеливые могут посмотреть\поиграть, скачав игру тут, а пользователи Ubuntu 18.04 могут установить игру apt'ом:
      sudo apt install -y piu-piu
      

      Далее небольшой рассказ о процессе создания и разбор интересных (по моему мнению) мест.
      Читать дальше →
    • Волшебное введение в алгоритмы классификации

      • Translation
      Перевод статьи Брайна Беренда.

      Когда вы впервые приступаете к изучению теории анализа и обработки данных, то одними из первых вы изучаете алгоритмы классификации. Их суть проста: берётся информация о конкретном результате наблюдений (data point), на основании которой этот результат относится к определённой группе или классу.

      Хороший пример — спам-фильтр электронной почты. Он должен помечать входящие письма (то есть результаты наблюдений) как «спам» или «не спам», ориентируясь на информацию о письмах (отправитель, количество слов, начинающихся с прописных букв, и так далее).



      Это пример хороший, но скучный. Спам-классификацию приводят в качестве примера на лекциях, презентациях и конференциях, так что вы наверняка уже не раз слышали о нём. Но что если поговорить о другом, более интересном алгоритме классификации? Каком-то более странном? Более… волшебном?


      Всё верно! Сегодня мы поговорим о Распределяющей шляпе (Sorting Hat) из мира Гарри Поттера. Возьмём какие-то данные из сети, проанализируем и создадим классификатор, который будет сортировать персонажей по разным факультетам. Должно получиться забавно!
      Читать дальше →
      • +22
      • 13.2k
      • 1
    • Как с помощью руководства пользователя повысить качество информационной системы

        В действительности все совершенно иначе, чем на самом деле.
        Антуан де Сент-Экзюпери


        Многое в разработке руководства пользователя регламентировано и описано ГОСТами. Но при создании больших гетерогенных систем могут возникать вопросы, не до конца освещенные этими документами.

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

        Статья будет полезна для тестировщиков, технических писателей, аналитиков и даже для руководителей проектов.

        Читать дальше →
      • Как сделать идеальный туториал для хардкор геймеров и их мам

        • Translation
        В этой статье мы хотим представить вам конспект с выступления Джоржа Фэна — создателя Plants vs Zombies, любителя стейков сильной прожарки и редких карт Magic: The Gathering.

        Джордж весело и конструктивно описывает процесс создания и интеграции туториала для своей игры. А универсальность и простоту обучения подтверждает рассказом о том, как его мама, до этого не сталкивавшаяся с видеоиграми, прошла всю Plants vs. Zombies и победила последнего босса. Основной посыл Джорджа таков: люди любят учиться, но не всегда об этом знают. А при первом знакомстве с игрой именно туториал является определяющим фактором того, станет ли пользователь играть и получать удовольствие от геймплея, или в ужасе закроет игру и с воплями убежит в горизонт.


        Читать дальше →
      • Подборка полезных слайдов про Linux

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


        Читать дальше →
      • С маленькой или с Большой

        • Translation
        Такая мелочь, как применения заглавных букв может быть весьма важной. Для английского языка. Статья будет особенно полезна тем, кто занимается разработкой продуктов на английском.
        (Кстати, кто еще не знает, «вуз» пишется маленькими буковками.)

        image

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

        Ну что ж, если вы пишите приложение для сайта, вас это должно волновать. Такая мелочь, как применение заглавных букв (капитализация) может быть весьма важной. Капитализация влияет на читабельность, понимание и удобство использования. Она даже влияет на то, как люди видят ваш бренд.

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

        Читать дальше →
      • Введение в DPDK: архитектура и принцип работы

        • Tutorial
        DPDK

        За последние несколько лет тема производительности сетевого стека Linux обрела особую актуальность. Это вполне понятно: объёмы передаваемых по сети данных и соответствующие нагрузки растут не по дням, а по часам.

        И даже широкое распространение сетевых карт 10GE не решает проблемы: в самом ядре Linux имеется множество «узких мест», которые препятствуют быстрой обработке пакетов.
        Читать дальше →