Конкурс инструкций

Конкурс: инструкция на техническую тему

Объявляем победителей.

Материал подготовлен при поддержке Selectel

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

Жюри из Selectel и «Комитета» оценили актуальность тем, логику и структурированность изложения и, конечно, оформление.

А Selectel отметил и победителей, и других сильных участников конкурса — в собственном рейтинге топ-10 инструкций.

Единогласный победитель конкурса — Pavel Sherer, который написал инструкцию о том, как создать грамотную регистрацию через email и соцсети. Жюри отметило: благодаря оглавлению, схемам и грамотному структурированию разобраться в процессе с множеством нюансов очень просто.

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

Мурод Хайдаров, ведущий бэкенд-разработчик

Pavel Sherer получает 13-дюймовый Macbook Air.

Евгений Усов создал детальную и при этом понятную инструкцию по работе с Flutter, SDK от компании Google для создания мобильных приложений. Жюри отметило наглядность примеров, пояснения к коду и простоту изложения.

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

Пётр Савченко, ведущий фронтенд-разработчик

Евгений Усов получает iPhone 11 Pro, 64 ГБ.

Artur Makhnach выбрал довольно сложную тему параллельных вычислений, актуальную для многих разработчиков. Жюри отмечает: читать сложный материал было нескучно и интересно. Автор прокомментировал код, прикрепил много полезных ссылок и качественно оформил материал.

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

Евгений Делюкин, обозреватель vc.ru

Artur Makhnach получает Apple Watch Series 5.

Остальные участники

Все участники конкурса получат промокод номиналом 1000 рублей на баланс Облачной платформы в Selectel, который можно использовать в любом из существующих или новых проектов. Промокод будет действителен до 31-го декабря 2020 года. Он будет выслан в личном сообщении участникам состязания.

Что значит «инструкция»:

  • Это текст, который решает техническую задачу или проблему и отвечает на вопрос «Как это сделать». То есть пошагово ведёт к решению вопроса.
  • Читатель такой инструкции — ИТ-специалист любого уровня.

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

Вот пара примеров неплохих инструкций:

Как принять участие

  • Зайдите в подсайт «Разработка» и подпишитесь на него.

  • Нажмите кнопку «Создать запись» в верхней панели сайта или кнопку в конце статьи, зайдите в редактор.
  • Напишите инструкцию, выберите «Разработку» в качестве подсайта. В конце вашего текста поставьте хэштег #selectel_инструкция — так работа попадёт в конкурсный пул.
  • Сделайте всё это до 21 сентября.
  • Дело за малым — дождитесь подведения результата. В это время вы можете посмотреть работы других участников по тегу #selectel_инструкция.
Вот два важных правила — чтобы ваша инструкция попала в конкурсную программу

Как написать хорошую инструкцию

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

Вот рекомендации, которые сделают инструкцию читаемой, а значит, повысят шансы на победу:

Задайте вектор повествования

Пользователь в первом абзаце должен понять, зачем ему читать инструкцию и к какому результату она приведёт. Заголовок должен быть кратким и ёмким — из него читатель должен понять суть текста.

Мы не оцениваем длину текста, поэтому вода не нужна

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

Структурируйте текст

Делайте инструкцию в пошаговом формате — так будет проще воспринимать информацию. Старайтесь разбивать абзацы больше шести–семи строк на более мелкие.

Подумайте над оформлением материала

В редактор статей можно вставлять картинки, гифки, видео, делать врезки.

Если остались вопросы по оформлению материала, прочтите нашу инструкцию о том, как написать хороший материал на vc.ru.

Избегайте заимствований

Инструкция должна быть авторской: неприкрытый плагиат не пройдёт в конкурсную программу.

Как будет проходить конкурс

Конкурс продлится четыре недели — с 27 августа по 1 октября. Материалы будем принимать до 23:59 21 сентября. После окончания приёма работ в течение недели подведём итоги конкурса и определим победителей.

Работы оценят шесть членов жюри. Каждой работе они выставят от 0 до 10 баллов. Побеждают те, кто набрал максимум очков.

Количество статей от одного участника не ограничено — если, конечно, все требования соблюдены.

В сентябре мы объявим победителей в этом же материале. А жюри обоснует свой выбор. Лучшие работы участников конкурса Selectel опубликует на своём сайте.

Призы

Все участники конкурса получат промокод номиналом 1000 рублей на баланс Облачной платформы в Selectel, который можно использовать в любом из существующих или новых проектов. Промокод будет действителен до 31-го декабря 2020 года.

Тройке победителей достанутся другие призы:

  • Первое место — Apple MacBook Air 13 дюймов, 2020 года.
  • Второе место — Apple iPhone 11 Pro 64 ГБ.
  • Третье место — Apple Watch Series 5, 44 мм.

Призы мы доставим, но только по территории России. Если вы в Москве, забрать их можно будет из офиса «Комитета» — передадим награду прямо в руки. Вот тут правила конкурса прописаны подробнее.

Немного о Selectel

Selectel — провайдер ИТ-инфраструктуры в России. Предоставляет услуги по размещению и аренде серверов в физических дата-центрах и в «облаке», развивает платформенные сервисы. Шесть дата-центров компании расположены в Санкт-Петербурге, Москве и Ленинградской области.

На инфраструктуре Selectel развиваются такие компании, как Ситимобил, Петрович, ЦИАН, группа «ПИК», Яндекс.Еда. Всего более 18 000 клиентов — от индивидуальных предпринимателей до крупных международных корпораций.

Selectel поддерживает партнерства с такими «облачными гигантами», как Amazon Web Services, Google Cloud Platform, Microsoft Azure — с 2017 года. А в 2020 году компания получили статус Principal Partner Cloud Provider от VMware, американской компании, крупнейшего разработчика ПО для виртуализации.

0
51 комментарий
Написать комментарий...
Андрей Халимоненко

Не справился с первым заданием – не смог выбрать раздел «Разработка» (((
Как и где выбрать этот раздел?

Ответить
Развернуть ветку
Янис Зятьков

Если узнаете - напишите инструкцию. Легчайшее первое место.

Ответить
Развернуть ветку
Антон Запевалов

Реально нет подсайта. Забыли добавить что-ли?

Ответить
Развернуть ветку
1 комментарий
Evil Pechenka

https://vc.ru/sitemap/standard

Чтобы подсайт выбирался нужно на его подписаться.

Другие полезные ссылки:

https://vc.ru/sitemap
https://vc.ru/rating
https://t.me/cspy_bot — бот Телеграм с уведомлениями о новых подсайтах издательства «Комитет»

P.S. #selectel_инструкция 😁

Ответить
Развернуть ветку
Ekaterina Ivanova

Раздел существует, добавили ссылку для удобства👍

Ответить
Развернуть ветку
3 комментария
Stack

Я тоже нефига не понял((

Ответить
Развернуть ветку
1 комментарий
Аккаунт удален

Комментарий недоступен

Ответить
Развернуть ветку
Звенислав Николаевич

«Работает – не трогай»

Ответить
Развернуть ветку
Roustem Fa

Трогает—не_работай

Ответить
Развернуть ветку
1 комментарий
Гаррик Барсуков

Авторы, уточните, пожалуйста: правильно я понимаю, что под технической инструкцией имеется в виду техническое задание (постановка задачи) разработчику на разработку и/или оптимизацию того или иного продукта?
Всё-таки называть ТЗ технической инструкцией не совсем корректно, на мой взгляд

Ответить
Развернуть ветку
Саша Мураховский

Нет, мы ждём не техническое задание, а именно инструкцию — структурированный текст, который решает какую-то проблему. Вот неплохой пример — https://vc.ru/selectel/22593-howto-bot-selectel

Ответить
Развернуть ветку
2 комментария
Гаррик Барсуков

@Ekaterina Ivanova , вопрос, я так понимаю, к вам

Ответить
Развернуть ветку
Наталья Мальцева

Я думала что технические инструкции больше нужны не разработчикам, а юзерам - операционным пользователям, котрым потом с этой разработкой работать ) 

Ответить
Развернуть ветку
Виктория Главчева

Ребята, спасибо за конкурс!
Во-первых, написано столько интересных инструкций! Можно найти и изучить что-то новое, авторы креативно и доступно описали то, в чем разбираются, приятно читать.
Во-вторых, конкурс дал толчок (во всяком случае для меня, но уверена такие еще найдутся) не только потреблять, но и созидать. Таким образом еще шаг вперед!
В-третьих, в конкурсе есть призы, которые порадуют участников за старания, мелочь, но кому-то будет приятно)

Ответить
Развернуть ветку
Роман Веснин

Самая понятная и полезная инструкция, которая упростила жизнь разработчикам:
"Иди погугли"

Ответить
Развернуть ветку
Влад Ижевский

Вы победили и стали единым владельцем акций компании Selectel

Ответить
Развернуть ветку
Maxim Bugaev

хм, а если уже давно производишь только видео-инструкции?...

Ответить
Развернуть ветку
Aleksandr Tugov

Записать видеоинструкцию и вставить её в свою статью по инструкции в этой статье =)

Ответить
Развернуть ветку
hakhagmon
Ответить
Развернуть ветку
Евгений Усов

Офигеть! Не думал, что выиграю. Спасибо за конкурс! Как теперь получить приз? На почту ничего не приходило :-) 

Ответить
Развернуть ветку
Evil Pechenka

Примеров нет — не понятно на какую тему должна быть инструкция.Что такое «технические инструкции»? Вот у меня статьи как выбрать устройство для просмотра телевидения или как упорядочить закладки — это технические инструкции или не технические?

Ответить
Развернуть ветку
Саша Мураховский

Всё, что вы привели в качестве примера подходит для участия в конкурсе — мы намеренно не ограничивали тематику. Поэтому инструкция о том, как упорядочить закладки тоже подойдёт, но учитывайте специфику издания — возможно, об упорядочивании закладок на vc.ru читать уже будет не очень интересно. 

Ответить
Развернуть ветку
2 комментария
Kanat Omar

Так этого раздела нет в списке, как показано на примере.
Откуда взяли скрин в примере тогда?

«Нажмите кнопку «Создать запись» в верхней панели сайта или кнопку в конце статьи, зайдите в редактор».

Недостоверная инструкция?
В списке кнопки на верхней панели подраздела нет, и кнопки в конце статьи тоже.

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

Ответить
Развернуть ветку
нурым

нужно подписаться на подсайт разработка

Ответить
Развернуть ветку
Ekaterina Ivanova

Здравствуйте!
Чтобы раздел «Разработка» появился в списке, на него сначала нужно подписаться. Находите подсайт в общих подписках, подписываетесь, - после этого «Разработку» можно будет выбрать в редакторе при написании статьи.   

Ответить
Развернуть ветку
Юлия Пеленева

по ссылке с правилами 404 

Ответить
Развернуть ветку
Темир Ипиев

А почему всегда только Appl'овская продукция разыгрывается?) Нигде не видел, чтобы условный Xiaomi разыгрывали.

Ответить
Развернуть ветку
Стефан Васадзе

Помогу написать, отредактировать и оформить за полприза😂

Ответить
Развернуть ветку
Влад Ижевский

Инструкция к инструкции:
1. Внимательно читайте инструкцию! 

Ответить
Развернуть ветку
Степан Турченко

Добрый день, подскажите, когда ставить напоминание о просмотре результатов 29 сентября или раньше? 

Ответить
Развернуть ветку
Аккаунт удален

Комментарий недоступен

Ответить
Развернуть ветку
KeeF3ar

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

Ответить
Развернуть ветку
4 комментария
Righteous Hippie

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

Ответить
Развернуть ветку
KeeF3ar

Сижу с macbook air 2020, а вот трубка не помешает.Вопрос: "как занять второе место?"

Ответить
Развернуть ветку
Vladimir Komarov

А что мешает занять первое и предложить "ченьдж"  серебряному призёры? 
IMHO,  вероятность удачи высока . . .
: -)))

Ответить
Развернуть ветку

Комментарий удален модератором

Развернуть ветку

Комментарий удален модератором

Развернуть ветку
Викентий Роскошный

Господа, а я правильно посчитал, и завтра до 23:59:59 мы узнаем в этом посте результаты конкурса?
Или есть какие-то нюансы?

Ответить
Развернуть ветку
Sm0L
Нет, мы ждём не техническое задание, а именно инструкцию — структурированный текст, который решает какую-то проблему

На первом месте именно ТЗ )

Ответить
Развернуть ветку
48 комментариев
Раскрывать всегда