Blog

  • Выбираю платформу для базы знаний

    Выбираю платформу для базы знаний

    За последнее время часто возникает потребность создания документации или базы знаний в разных проектах. Сколько бы мне ни нравился Obsidian для личных заметок, для коллективного использования в вебе он не предназначен. Поэтому я начал поиск продукта “база знаний”.

    Требования:
    – Поддержка русского языка
    – Статьи можно писать коллективно
    – Можно опубликовать на моём домене
    – Хочу поддержку markdown
    – Современный внешний вид из коробки, который легко брендировать
    – Приятный интерфейс и UX

    Рассматривал все варианты.
    Первыми не подошли зарубежные платные продукты: Gitbook, Notion, Confluence, Zendesk. Зачем сразу создавать себе проблемы с оплатой и блокировками?
    Потом стал смотреть российские платные: Teamly — альтернатива для Notion, CarrotQuest — альтернатива для ZenDesk/Intercom, Kaiten — альтернатива для Jira. В Kaiten мы даже сделали книгу сотрудника для агентства и остались довольны, но это всё же не для публичного доступа.

    Потом опомнился, что не хочу платить за подписки. Я готов разворачивать и админить приложения в нашей инфраструктуре. Начал смотреть на Open Source, чтобы бесплатно и с открытым кодом. Оказывается, не так много хороших решений.
    Outline и Documize оказались продуктами с платными версиями, не стал разбираться в тонкостях лицензий, убрал их из сравнения.
    BookStack — не понравился редактор статей, весь продукт выглядит устаревшим. Ставили его пару лет назад и пробовали использовать, но не прижился.
    GitLab — почему бы не писать документацию для разработчиков внутри репозитория? Решил опробовать, но для публичной базы знаний нужно что-то другое.

    В итоговой выборке остались эти продукты:
    Wiki.js — победитель, пока остановился на этом продукте и буду его пробовать. Множество плагинов, поддержка разных баз данных, корпоративный логин, markdown, всё выглядит очень современно.
    Docusaurus — второе место, поддерживает переводы и версии, отлично выглядит и тоже полностью открытый исходный код без скрытых тарифов.

    Занятно, что оба написаны на Node.js + TypeScript. Хотя я на стек смотрел в последнюю очередь.

    А на какой платформе база знаний у вас и насколько вы ей довольны?

  • Лидген на отраслевых выставках

    Лидген на отраслевых выставках

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

    1. Выбираем выставку на сайте местного экспоцентра. Недвижимость, туризм, HR, пчеловодство, загородное строительство или фэшн — в расписании выставки сменяют друг друга круглый год.
    2. Готовим хотя бы один тематический кейс под эту выставку.
    3. Кейс загружаем в ноутбук или планшет.
    4. Печатаем визитки, а то даже и буклет.
    5. Надеваем лучшую рубашку, часы, бреем бороду, замазываем прыщ. В общем, всё что нужно для уверенности и делового вида.
    6. На каждом стенде спрашиваем директора по маркетингу, главного за продвижение, руководителя отдела продаж или “с кем у вас про рекламу поговорить?”
    7. Показываем отраслевой кейс, отвечаем на вопросы, оставляем визитку, берём контакты. Договариваемся на следующий звонок или встречу.
    8. Профит!

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

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

  • Обнови свой HTTP

    Обнови свой HTTP

    Что такое:
    Протокол передачи данных HTTP применяется для всех сайтов в интернете.
    Все самые популярные веб-серверы по умолчанию используют устаревшую версию протокола HTTP/1.1. Apache2, NGINX, Node.js, uWSGI, Gunicorn, Tomcat, Jetty, IIS — все виновны.

    Браузер пытается одновременно скачать с сайта код, десятки картинок и скриптов. На HTTP/1.1 браузер открывает несколько параллельных соединений, в каждом из которых файлы загружаются по очереди. С HTTP/2 открывается одно соединение, по которому одновременно загружаются все файлы. HTTP/3 ещё быстрее и лучше работает в мобильных сетях.

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

    Год выхода стандарта:
    HTTP/1.1 — 1997
    HTTP/2 — 2015
    HTTP/3 — 2022

    Как обновить:
    В большинстве серверов HTTP/2 уже встроен, но его нужно явно включить в конфигурации. В NGINX достаточно добавить слово “http2” в конфигурацию и всё заработает, настолько всё просто.

    HTTP/3 достаточно свежий, поэтому для многих серверов нужно будет ставить дополнительные модули. Сисадмину будет интересно с этим разобраться.

    Как проверить:
    Из консоли любой операционки

    curl -I https://example.com

    На первой же строке ответа будет указана версия протокола: HTTP/1.1, HTTP/2, или HTTP/3

  • Сравнительный анализ

    Сравнительный анализ

    Почему-то иногда мы забываем, что не всё должно получаться с первого раза.
    Ходить мы учились очень долго — разбивали коленки и лбы. А приносящий клиентов сайт и рекламная кампания должны были получиться с первого раза!
    Но опыт накапливается постепенно…

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

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

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

  • Работник ПВЗ

    Работник ПВЗ.
    Будущее неравномерно распределено.

  • Тестирование для вайб-кодинга

    Тестирование для вайб-кодинга

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

    – Без тестов мы не можем быть уверены, что ИИ не разрушил часть работающего функционала. Галлюцинации и потеря контекста вносят неожиданные проблемы, которые тесты могут выявить.
    – В среднем, код сложнее, чем тесты — у него больше вариантов в результате исполнения. Предполагаю, поэтому ИИ будет проще писать хорошие тесты, чем хороший код.
    – Автоматизированное тестирование станет более доступным по цене и не таким трудоёмким в создании: большая часть рутинного кода будет писаться тоже с помощью ИИ. Очень мало причин не обзавестись регрессионными тестами.
    – В ближайшее время появится множество инструментов для покрытия тестами, ревью кода, анализа и исправления ошибок с помощью ИИ.
    – Аудиты на безопасность и нагрузочное тестирование сможет запускать агент.

    Есть обратная сторона. ИИ может писать такой код, чтобы он проходил тест, а не решал поставленную задачу. Он может даже подменять ожидаемое значение, лишь бы пройти тест. Хорошо на этот случай иметь множество разных проверок кода — юнит-тесты, статический анализ, линтеры, попытка компиляции, функциональное тестирование, интеграционные и e2e-тесты, автоматизированное и ручное ревью кода.

    Как мне кажется, объём и качество тестирования будет расти. Возможно, будет нужен агент или человек для тестирования тестов!

  • Фильм: Человек, который изменил всё / Moneyball

    Фильм: Человек, который изменил всё / Moneyball

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

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

    В главных ролях Брэд Питт и Джона Хилл (из “Волка с Уолл-стрит”), 6 номинаций на “Оскар” и всё это основано на реальных событиях.

    Этот фильм я часто рекомендую руководителям, потому что ценно и мало кто его смотрел. Кино спокойное, не травмирует психику — можно смотреть на ночь.

  • Рассказал про лидген в агентство

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

    Был рад получить тёплый отзыв в чате от Гульшан из BeautyMedMarketing
    Думаю, начали месяц Лидгена прямо оочень хорошо.
    Михаил собрал всю базу, которая работает на сегодня, которую буквально отработал на себе. Обязательно посмотрите эфир и презу👌
    Мне как раз нужна была помощь в инфе про холодные звонки. Михаил подробно рассказал, как выстроен этот процесс.

    В эфире я кратко рассказал о своём опыте получения клиентов для диджитал агентства. По каждому из этих источников можно сделать развёрнутую лекцию или хотя бы пост.
    1. Сарафан / рекомендации
    2. SEO
    3. Холодные звонки
    4. Отраслевые конференции и выставки
    5. Контекстная и таргетированная реклама
    6. Чаты
    7. Партнёрские программы

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

    Для участников Галеры — запись эфира на платформе, презентация в общем чате и особые условия на моё менторство у вашего менеджера.

    Для не участников клуба напоминаю, что даю персональные консультации. Пишите по этому поводу в личку @vseznaika

  • Закрывайте тестовые сайты от индексации

    Закрывайте тестовые сайты от индексации

    Часто веб-студия разворачивает тестовый сайт для демонстрации клиенту: сделать приёмку сайта до публикации, посмотреть на новый дизайн или на экспериментальные функции.

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

    Самый простой и надёжный способ — HTTP Basic Auth. При вводе адреса тестового сайта вылезет диалог с логином и паролем. Задаётся всё в конфигурации веб-сервера, работает и для Nginx и для Apache. Девопсы и сисадмины знают, как быстро настроить эту фичу.

    Код проекта не затронут — разработчикам ничего не нужно делать. Поисковые роботы не могут посетить сайт — спокоен SEOшник. И случайные люди не смогут на сайт попасть.

  • Часовое видео — за 5 минут

    Часовое видео — за 5 минут

    Часто мне нужно посмотреть длинное видео, и это вовсе не развлекательный контент.

    Как я с этим справляюсь:
    – Делаю запрос в поисковике “youtube video to text online”
    – Открываю сразу 2-3 инструмента
    – Выбираю тот, который работает без регистрации. Сейчас чаще всего использую https://youtubetotranscript.com/
    – Могут подойти разные инструменты, в зависимости от того, говорит в видео один или несколько человек, нужны ли метки с временем
    – Вставляю в сервис ссылку на ролик
    – Практически моментально получаю весь текст из видео
    – Дальше вставляю его в AI-чат
    – Сообщаю ему, что это транскрипт видеоролика. Прошу сделать саммари/выжимку или задаю вопросы к тексту
    – Читаю выжимку

    Экономия времени: вместо 1 часа на просмотр — 5 минут на транскрибацию и чтение выжимки.

    Если видео не на Youtube:
    – скачать видео с помощью расширения для браузера
    – загрузить на свой Youtube-аккаунт в режиме unlisted (доступ по ссылке)
    – дать транскрибатору эту ссылку для расшифровки
    – после транскрибации видео можно удалить

    PS: Несколько читателей посоветовали использовать для этих целей https://notebooklm.google. Спасибо!

    ❤️ Нажми на сердечко, если нравится подход
    ⚡️ Нажми на молнию, если полезно
    🧑‍💻 Нажми на ботана, если уже так делаешь