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

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

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

Материал подготовлен при поддержке 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": "self", "tags": ["selectel_\u0438\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u044f"], "comments": 51, "likes": 19, "favorites": 95, "is_advertisement": true, "subsite_label": "promo", "id": 152560, "is_wide": true, "is_ugc": true, "date": "Thu, 27 Aug 2020 13:52:08 +0300", "is_special": false }
Конкурс технических инструкций
0
51 комментарий
Популярные
По порядку
Написать комментарий...

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

11

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

59

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

3

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

0

https://vc.ru/sitemap/standard

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

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

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

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

1

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

0

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

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

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

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

2

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

0

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

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

6

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

0

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

1

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

5

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

4

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

3

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

2

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

2

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

3

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

4

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

0

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

0

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

3

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

3

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

1

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

5

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

2

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

1
2

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

2

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

1

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

1

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

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

4

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

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

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

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

1

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

1

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

0

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

1

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

1

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

1

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

1

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

1

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

–6

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

1

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

–1

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

0

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

1

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

1

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

–2

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

1

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

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

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

0

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

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

0
Читать все 51 комментарий
Жизнь и удаленная работа во Вьетнаме: почему работать со сдвигом на 4 часа — это хорошо

Чтобы разобраться, как живется во Вьетнаме на самом деле, мы пообщались с аналитиком, которая с 2013 года живет здесь с супругом и не собирается никуда уезжать. Она расскажет, какие тут на самом деле цены, как обстоят дела с развлечениями и медициной и в чем главное отличие Вьетнама от других стран Юго-Восточной Азии.

Прошел финал программы скаутинга в киберспорте Winstrike

Итоги программы Winstrike Scouting powered by UltraGear

Создал ледовый комбайн в 50, а вместе с ним и рынок таких машин, который сразу захватил — это изобретатель Фрэнк Замбони Статьи редакции

Иногда ледозаливочные машины других производителей по ошибке называют «Замбони», пишет The Hustle.

Ледовый комбайн Замбони Time
«Яндекс» отказывается решать проблему с сетью Тele2 на «Яндекс.Телефон». Проблема вызвана отсутствием поддержки

Так случилось, что стал обладателем «Яндекс.Телефона» в ноябре прошлого года. Аппарат был куплен через площадку «Яндекс.Маркет» (Заказ № 28218750). Практически через неделю вместо оператора появилась уже ставшая знаменитой в узких кругах (среди владельцев «Яндекс.Телефонов») ошибка с крестами.

Хомяк-криптотрейдер заработал 30% за три месяца в «клетке для торговли» — обойдя Уоррена Баффета и S&P 500 Статьи редакции

Мистер Гокс занимается торговлей криптовалютой с 12 июня.

Готовы выбрать победителя премии «Экспортер года eBay — 2021»?
Я скрестил «Трибуну» и Product Hunt

Теперь вы никогда не пропустите самые перспективные русскоязычные стартапы.

Нужны ли в России сити-фермы

И появятся ли грядки на крышах пятиэтажек.

re-thinkingthefuture.com
Увидеть первые Apple, сделать копию на ксероксе и потрогать мышку: как в Минске-88 прошла выставка «Информатика в США» Статьи редакции

Выставка стала потрясением для жителей: это было похоже на фильм «Назад в будущее», который на выставке тоже показывали, рассказывает dev.by. Издание поговорило с экс-гидом той выставки и минчанами, которые до сих пор хранят значки с её логотипом.

Как мы проводили командную ретроспективу в Minecraft

Рассказываем историю, на что стоит обратить внимание при проведении командного мероприятия в игре Minecraft, какие грабли могут быть, как организовать онлайн- и офлайн-участие.

Как традиционному малому бизнесу превратиться в стартап: план действий

Сейчас в России предприниматели переходят из традиционного малого бизнеса в стартапы очень редко — меньше чем в 0,02% случаев. Это не больше 1 000 стартапов из около 6 млн предприятий малого бизнеса. Поговорим о том, что мешает предпринимателям и как действовать, если есть желание создать стартап.

null