Конкурс инструкций
Промо
28 951

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

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

В закладки

Материал подготовлен при поддержке 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, американской компании, крупнейшего разработчика ПО для виртуализации.

{ "author_name": "Ekaterina Ivanova", "author_type": "editor", "tags": ["selectel_\u0438\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u044f"], "comments": 51, "likes": 19, "favorites": 97, "is_advertisement": true, "subsite_label": "promo", "id": 152560, "is_wide": true, "is_ugc": false, "date": "Thu, 27 Aug 2020 13:52:08 +0300", "is_special": false }
Конкурс технических инструкций
0
51 комментарий
Популярные
По порядку
Написать комментарий...
11

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

Ответить
59

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

Ответить
3

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

Ответить
0

Добавили в текст ссылку на подсайт, раздел, конечно, существует)

Ответить
1

https://vc.ru/sitemap/standard

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

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

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

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

Ответить
0

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

Ответить
2

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

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

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

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

Ответить
0

Перед тем как подсайт «Разработка» появится в поле для выбора в текстовом редакторе, на него нужно подписаться. Этот раздел есть в общем списке подсайтов -  https://vc.ru/dev

Ответить
6

Всего–то, нужно было написать несколько слов в скобках изначально.

Хорошо, что скорректировали статью.

Ответить
0

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

Ответить
1

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

Ответить
5

Обрадовался фразе на "любую тему", а оказывается только в ИТ

Ответить
4

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

Ответить
3

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

Ответить
2

Не лезь, она тебя сожрет!

Ответить
2

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

Ответить
3

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

Ответить
4

Ну, вот это и не очевидно было(
Просто в статье указано «Главное, чтобы техническая инструкция была полезной и понятной ИТ-разработчикам любого уровня»
Пример, на который вы ссылаетесь, ориентирован на пользователя, а не разработчика, т.к. там нет ничего, что было бы связано с разработкой и требовало бы написание хотя бы одной строки кода в среде разработки

Ответить
0

Это гайд скорей, или мануал. Тех инструкция все таки о другом)

Ответить
0

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

Ответить
3

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

Ответить
3

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

Ответить
1

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

Ответить
5

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

Ответить
2

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

Ответить
1

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

Ответить
2

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

Ответить
1

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

Ответить
1

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

Ответить
4

А ещё вопрос — вы предлагаете размещать статьи в раздел «Разработка», но если я вот такую статью про закладки там размещу, то меня заминусуют, потому, что это явно не та рубрика, а редактор перенесёт. Что с этим делать?

И «Разработка» это не рубрика по умолчанию, там одни программисты, им статьи общего профиля не понравятся.

Ответить
1

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

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

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

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

Ответить
1

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

Ответить
0

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

Ответить
1

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

Ответить
1

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

Ответить
1

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

Ответить
1

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

Ответить
1

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

Ответить
–6

@Евгений Делюкин 
Скорей бы вы уже отказались от практики дарить вещи от Яблока победителям, это как-то пошло, да и качество у них сомнительное. 

Ответить
1

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

Ответить
–1

Слушай, таких ноутбуков полно, особенно с уровнем производительности макбуков 

Ответить
0

ссылочку в студию) а что по производительности?) эйр, 3-4 jetbrains ide, хром с 20 вкладками + еще софтинки по работе, не лагает. Выше производительность нужна разве что для игр, или для рендера, геймеры явно под ца не попадают. Объективно, если для работы, конкрурентов, как таковых, нет.

Ответить
1

2 и 3 еще имеют потенциал(надо в живую потыкать хоть часик), но через года два скорее всего превратятся в тыкву. Конкретно под себя, есе не мак, смотрел бы в сторону третьего, но легче 30к доплатить и получить точно хороший аппарат, с удобной ос(на тех ноутах ставил бы linux, из-за рабочих моментов, винда только на стационарке стоит для поиграть) который через  пару лет на вторичке по хорошей цене улетит. 
остальное c fullhd и\или пластиком экранами это уже мрак как несколько лет.

Ответить
1

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

Ответить
–2

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

Ответить
1

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

Ответить

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

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

0

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

Ответить
0

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

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

Ответить

Комментарии

null