А как вы проводите выходные?

Эти у меня получились довольно продуктивными.
Добил курс на «Степике», который купил еще в прошлом сентябре, и получил сертификат.

Курс, кстати, очень рекомендую. Будет полезен новичкам и опытным.

🚀 Друзья, 2-ая международная конференция технических писателей TechWriter Days пройдет 28-29 марта 2025 года в Санкт-Петербурге в офлайн и онлайн формате.

‼️Разыгрываем‼️
🎫1 офлайн и 1 онлайн билеты
🎫скидка 50% на 2 офлайн и 2 онлайн билета
🎫скидка 30% на 3 офлайн и 3 онлайн билета

Наш информационный партнер — компания documentat.io и их документационный опрос😉

Как принять участие? Всё просто:
🔹Пройди опрос от нашего партнера, сделай свой вклад в изучение техписательского сообщества!
🔹Вступи в телеграм-группу конференции

⚡️Итоги подведём 25 февраля в этой же группе TechWriter Days!

Станьте частью этого долгожданного события! Ждём вас на Конференции❤️

Все знают, что такое Kubernetes. Правда же?
Но если хотите узнать больше, приходите 27 марта на Deckhouse Conf.

Жизненно

Лампочка сломана — что делать?

Меня в другом канале показывают. Красивое.

Вторая Международная конференция технических писателей TechWriter Days / 2 старутет только послезавтра. Но подписчики моего канала уже сегодня могут воспользоваться полезнотой, которой я поделюсь во время своего доклада про документирование GraphQL API.
Ловите ссылку на репозиторий, который позволит вам потренироваться в документировании GraphQL API. Пользуйтесь и прокачивайте свои скиллы.
А все подробности, фишки и нюансы, касающиеся документирования GraphQL API — во время доклада. Буду рад видеть всех.

Коротко о TW Days 2

Техрайтерс дэйс — огонь конфа.
Здесь только нужная инфа.
Нетворкинг здесь удачно прёт.
Попал сюда — тебе везёт.

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

Спасибо оргам за конфу.
А спикерам — за их инфу.
Участникам — за позитив.
Здесь позитива просто взрыв.

Конфа, уверен, удалась.
Жаль, только, быстро пронеслась.
Нам всем пора на поезд иль на рейс…
До встречи на Техрайтерс дэйс.

Доклады с первой конференции Techwriter Days уже доступны!

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

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

Скорее переходите в наш канал VK Видео и смотрите доклады, которые помогут вам стать ещё круче в профессии. Будем рады вашим отзывам и комментариям!

Моя статья «Документирование HTTP API (и не только) с Foliant», написанная по мотивам доклада на TWD1, попала в шорт-лист «Технотекста-7». Правда, категории про техническую документацию в этом году не было. Но, что есть, то есть.
В общем, вы знаете, что делать.
https://habr.com/ru/companies/habr/articles/906136/

Спите? Ну тогда просыпайтесь!

Я наконец-то сделал это, переформатировал и опубликовал Курс по проектированию и документированию API в виде сайта на Github Pages.

Если вы до этого момента сомневались, стоит ли проходить, хватит сомневаться. Кликайте сюда и проходите курс.

Нашел в закромах

А ведь я когда-то (во времена фрилансерства) даже участвовал в «битве Главреда» (да-да, того самого, «всея руси» который, на букву Иль...хов). Выиграть не получилось. Но опыт был интересный.

Почему я тогда ввязался в это? В тот момент работал с клиентом, который продвигал услуги по защите авторских прав с упором именно на IT. А тут как раз и битва на эту тему нарисовалась. «А почему бы и нет?» — подумал я.

В общем, результат по ссылке.

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

Читаю сейчас широко известную книгу про сети. И с удивлением для себя обнаружил, что большие объемы информации быстрее (не всегда, а в определенных случаях, конечно же) быстрее передать с помощью… грузовика. И даже сервис есть такой у Amazon.

А я как-то и не задумывался о том, что так можно было.

UPD. Сервис, оказывается уже закрыли (но другие альтернативы остались). Спасибо подписчику за наводку 👍.

Знания лишними не бывают. Особенно, когда они про популярный SSG

А давайте замутим небольшую серию постов про Jekyll и Liquid.

Погрузимся в это все (совсем неглубоко), конечно же, на практике: сделаем своими руками страничку с простым генератором справочника API из OpenAPI-спецификации. А дальше вы сможете его доработать под свои нужды, если захотите.

Вы в в деле?

Если в деле, ставьте под постом 🔥 (и друзей своих зовите, кому это может быть интересно).
Если нет — ставьте 👀.

#tw_api_jekyll

Привет, как договорились выше, начинаем знакомство с Jekyll и Liquid на практике. Это и серия других постов по теме будут помечены тегом #tw_api_jekyll. В рамках серии постов мы попробуем наладить сборку сайта-справочника API из спецификации в формате OpenAPI.

Сегодня мы подготовим «почву» для нашего справочника.
Для этого выполните следующее:

1. Установите себе на компьютер Jekyll и все зависимости по инструкции для вашей ОС со страницы Installation документации этого SSG (приобнял пользователей Windows — у вас самая длинная инструкция ).

2. Создайте на своем компьютере новый проект с помощью команды (в терминале, консоли).

jekyll new tw_api_jekyll

Здесь вместо tw_api_jekyll можно использовать любое другое имя. Это — имя папки, в которой будет создан новый проект (сайт). Чтобы у нас с вами не было «рассинхрона», предлагаю оставить его как есть.

3. После этого перейдите в созданную папку:

cd tw_api_jekyll

4. Запустите сайт командой:

bundle exec jekyll serve

Если все сделано правильно, сайт с настройками по умолчанию будет доступен по адресу http://localhost:4000.

Откройте папку tw_api_jekyll в файловом менеджере, в IDE или посмотрите ее структуру в консоли (как вам удобно). Вы увидите следующую картину:

tw_api_jekyll /
├── _posts/                         # Папка для постов 
├── _site/                            # Папка со сгенерированными страницами сайта 
├── Gemfile                       # Файл зависимостей Ruby
├── Gemfile.lock              # Конкретные версии зависимостей (генерируется автоматически)
├── _config.yml               # Основной конфигурационный файл
├── .jekyll-cache/           # Кеш для ускорения сборки
├── 404.html                  # Шаблон для станицы 404
├── about.markdown    # Страница about
└── index.markdown    # Главная страница

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

Сделайте следующее:

1. Удалите папку _posts/ и файл about.markdown. Это мы делаем потому, что наш сайт-справочник API будет одностраничным.

2. Переименуйте файл index.markdown в index.md. Делать это не обязательно, с обоими расширениями Jekyll работает без проблем. Давайте считать это вкусовщиной: просто я привык использовать для Markdown-файлов расширение .md.

3. Откройте файл index.md и во фронтметтре (это фрагмент вверху страницы, заключенный в ---) удалите привязку к стандартному шаблону. Для этого удалите layout: home (или закомментируйте, это нам в будущем понадобится).

4. В начало файла index.md добавьте заголовок # Справочник TW_api. Сохраните файл.

Если все сделали правильно, по адресу http://localhost:4000 будет находиться страница с заголовком # Справочник TW_api без какой-либо разметки (т.к. мы «отвязались» от стандартного шаблона).

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