Команда, разрабатывающая софт для создания пользовательской документации, делится лайфхаками на тему написания идеальной пользовательской документации для тех, кто далёк от написания руководств к программе.
Пользователь
Почему пользователи не читают документацию или как можно улучшить руководство пользователя
3 min
Часть первая
Данная статья не предполагает каких-то заумных и крайне неочевидных советов по написанию и проверке технической документации. Многие из перечисленных «советов» многим покажутся очевидными, но из раза в раз, анализируя документацию наших пользователей, мы сталкиваемся с одними и теми же банальными ошибками, которые чаще всего происходят из-за фактора «забыл». Так что данный пост можно расценить как памятку не техническому писателю.
Приятного чтения
Руководство React Native — создаем приложение под iOS. Часть 1.1
5 min
Перевод отсюда.
Продолжение тут.
Идея создавать мобильные приложения на JS не нова. Мы видели, что фреймворки, такие как Ionic или PhoneGap, справляются с этой задачей и привлекли изрядное количество разработчиков.
Тем не менее ни эти фреймворки, ни идея создавать мобильные приложения на JavaScript никогда не привлекали меня. Я всегда думал, почему бы не изучить Swift/Objective-C или Java и просто делать настоящие приложения? Конечно, это потребует затраты значительных усилий на обучение, но разве непрерывное обучение — это не то, что мы, разработчики, делаем и должны делать хорошо? Быстро изучать новые языки и фреймворки? Тогда в чём смысл? Что касается меня, очевидные преимущества такого подхода никогда не перевешивали сомнения.
Продолжение тут.
Идея создавать мобильные приложения на JS не нова. Мы видели, что фреймворки, такие как Ionic или PhoneGap, справляются с этой задачей и привлекли изрядное количество разработчиков.
Тем не менее ни эти фреймворки, ни идея создавать мобильные приложения на JavaScript никогда не привлекали меня. Я всегда думал, почему бы не изучить Swift/Objective-C или Java и просто делать настоящие приложения? Конечно, это потребует затраты значительных усилий на обучение, но разве непрерывное обучение — это не то, что мы, разработчики, делаем и должны делать хорошо? Быстро изучать новые языки и фреймворки? Тогда в чём смысл? Что касается меня, очевидные преимущества такого подхода никогда не перевешивали сомнения.
gRPC в качестве протокола межсервисного взаимодействия. Доклад Яндекса
16 min
gRPC — опенсорсный фреймворк для удаленного вызова процедур. В Яндекс.Маркете gRPC используется как более удобная альтернатива REST. Сергей Федосеенков, который руководит службой разработки инструментов для партнеров Маркета, поделился опытом использования gRPC в качестве протокола для построения интеграций между сервисами на Java и C++. Из доклада вы узнаете, как избежать частых проблем, если вы начинаете использовать gRPC после REST, как возвращать ошибки, реализовать трассировку, отлаживать запросы и тестировать вызовы клиентов. В конце есть неофициальная запись доклада.
— Сначала хотелось бы познакомить вас с некоторыми фактами про Яндекс.Маркет, они будут полезны в рамках доклада. Первый факт: мы пишем сервисы на разных языках. Это накладывает требования по наличию клиентов для сервисов.
— Сначала хотелось бы познакомить вас с некоторыми фактами про Яндекс.Маркет, они будут полезны в рамках доклада. Первый факт: мы пишем сервисы на разных языках. Это накладывает требования по наличию клиентов для сервисов.
Вопросы на собеседовании для программистов компьютерной графики
4 min
Translation
Прим. переводчика: в данной статье обсуждается общий подход к выбору вопросов для собеседований на позицию программиста компьютерной графики на примерах конкретных вопросов.
Недавно я видел в твиттере довольно много дискуссий о хороших и плохих вопросах на интервью. Некоторые из этих вопросов выглядят полезными.
В основном, наиболее интересные из них выглядят открытыми. Они могут привести к весьма большим и разветвленным обсуждениям или даже не имеют «верного» ответа. В конце концов, вам, скорее, нужно не узнать ответ (он всё равно будет 42), а увидеть процесс решения проблемы и/или оценить общие знания и понять собеседуемого.
Ниже я приведу примеры, которые я использовал несколько раз, и они ориентированы на программистов графики с некоторым количеством опыта.
Как запустить свой проект на Product Hunt: руководство от администрации
14 min
Translation
Существуют десятки разных постов и статей, буквально каждая из которых претендует на звание «Полного руководства по запуску проекта на Product Hunt». Хотя авторы этих статей руководствуются благими намерениями и большинство их рекомендаций разумны, не все они соответствуют действительности. Этот пост коснётся всего, что могло ввести вас в заблуждение.
В этой статье мы расскажем:
В этой статье мы расскажем:
- Как разместить публикацию на Product Hunt
- На чём следует сосредоточиться
- Чего стоит избегать
- Как подготовиться заранее
- Как подавать свой продукт
- Бонус: Как сделать так, чтобы о вас рассказали официальные аккаунты Product Hunt в Twitter и Facebook, а также как попасть в рассылку, которую ежедневно получают сотни тысяч читателей (даже после запуска).
Как мы на Product Hunt выходили
5 min
Не так давно, а именно 22 июля, мы выходили на Product Hunt. Забегая наперед, скажу, что в топ-3 по итогам дня мы не попали, но какое-то время были достаточно близки к этому. Хочу поделиться опытом, что стоит и чего не стоит делать, чтобы стать счастливчиком на «Продакте».
Какие ошибки мы совершили на Product Hunt и как их избежать
7 min
Tutorial
26 августа 2015 года мы (Rubrain.com — каталог лучших русских фрилансеров. Новый проект бывших топ-менеджеров Fl.ru) опубликовались на Product Hunt. И хотя мы набрали достаточное количество голосов для вхождения в ТОП-10, мы заняли 15-е место. В этой статье я хочу рассказать о том, на какие грабли мы наступили, как получить максимальный эффект от площадки и чего вообще ожидать от Product Hunt.
Product Hunt — сообщество людей, интересующихся новыми продуктами и технологиями. По легенде вхождение в ТОП-10 (еще лучше в ТОП-3 дня или ТОП-10 недели) по итогам дня голосования позволяет попасть в e-mail рассылку следующего дня и получить внимание прессы, предложения об инвестициях и мировую известность. Голосование происходит после 0:00 и до 23:59 по Тихоокеанскому времени (Западное побережье США: Сан-Франциско, Сиэтл, Лос-Анжелес и т.д.; -11 часов разницы с Москвой). Для участия и голосования необходим Twitter-аккаунт.
Прежде чем начать работу по подготовке вашего проекта к публикации на Product Hunt, проанализируйте какие сервисы получают максимальное количество голосов и внимания. Вы можете обнаружить, что успехом пользуются всякого рода агрегаторы и каталоги, а также действительно крутые продукты вроде Tesla, Nebia Shower, HyperLapse и т.д. Первое место в списке "50 Most Upvoted Products" занимает проект Startup Stash. Именно его историю продвижение на Product Hunt вы встретите при поиске историй успеха. Введите * в поле поиска на сайте Product Hunt и вы увидите список продуктов с наибольшим количеством голосов.
Product Hunt — сообщество людей, интересующихся новыми продуктами и технологиями. По легенде вхождение в ТОП-10 (еще лучше в ТОП-3 дня или ТОП-10 недели) по итогам дня голосования позволяет попасть в e-mail рассылку следующего дня и получить внимание прессы, предложения об инвестициях и мировую известность. Голосование происходит после 0:00 и до 23:59 по Тихоокеанскому времени (Западное побережье США: Сан-Франциско, Сиэтл, Лос-Анжелес и т.д.; -11 часов разницы с Москвой). Для участия и голосования необходим Twitter-аккаунт.
Прежде чем начать работу по подготовке вашего проекта к публикации на Product Hunt, проанализируйте какие сервисы получают максимальное количество голосов и внимания. Вы можете обнаружить, что успехом пользуются всякого рода агрегаторы и каталоги, а также действительно крутые продукты вроде Tesla, Nebia Shower, HyperLapse и т.д. Первое место в списке "50 Most Upvoted Products" занимает проект Startup Stash. Именно его историю продвижение на Product Hunt вы встретите при поиске историй успеха. Введите * в поле поиска на сайте Product Hunt и вы увидите список продуктов с наибольшим количеством голосов.
CRISPR для чайников, или Краткая справка по быстрому редактированию ДНК
12 min
Возможность изменять фрагменты ДНК всегда была святым Граалем биотехнологии и медицины. CRISPR позволяет делать это с невиданной ранее скоростью и эффективностью. Считайте, что биологи раньше работали на пишущей машинке, а благодаря CRISPR в одночасье пересели на MacBook. Не зря открытие этого метода в 2020 году удостоилось Нобелевской премии по химии.
Под катом — рассказ о появлении CRISPR, принципах работы и применении в настоящем и будущем. Да, вы все верно поняли, это про редактирование коров, синюю клубнику и арбузы размером со сливу с Aliexpress.
IEC60027-2: Давайте использовать стандарты, или 1024 B == 1 KiB && 1024 B != 1 KB && 1000 B == 1 kB
5 min
Доброго времени суток, уважаемые!
В последнее время, читая различные статьи в хабре, всё больше стал замечать, что многие авторы до сих пор ничего не знают о ISO/IEC стандартах бинарных префиксов (KiB=кибибайт, MiB=мебибайт и т.д.) и постоянно путают их с SI префиксами (kB=килобайт, MB=мегабайт). Поэтому я решил ещё раз заговорить об этом в надежде, что, прочитав статью, ещё пара человек начнёт пользоваться стандартами!
Windows Defender SmartScreen вредит независимым разработчикам
4 min
Translation
Допустим, вы независимый разработчик и выпустили своё приложение. Чтобы упростить установку, вы создаёте установщик и начинаете его распространять. Какой-нибудь смелый экспериментатор загружает, запускает инсталлятор — но видит строгое предупреждение:
Windows SmartScreen блокирует запуск исполняемого файла
Действительно, в текущем окружении Windows активно блокирует запуск бинарных файлов через функцию SmartScreen.
Windows SmartScreen блокирует запуск исполняемого файла
Действительно, в текущем окружении Windows активно блокирует запуск бинарных файлов через функцию SmartScreen.
Почему все мои игры выглядят так отстойно
10 min
Translation
Мы потратили на создание этой игры несколько лет. От неё зависит будущее нашей семьи. Почему же она так ужасно выглядит?
Я уже 25 лет зарабатываю на жизнь написанием инди-игр. У нас с женой есть небольшой семейный бизнес. Мы создаём низкобюджетные ролевые игры в ретро-стиле с отличным сюжетом, дизайном и геймплеем.
Но все они выглядят как куча навоза.
Первая моя игра, выпущенная в январе 1995 года, тоже выглядела ужасно. Она достигла финансового успеха (очевидно, среди слепых людей), благодаря чему мне удалось профинансировать много других ужасно выглядящих игр и создать себе солидную репутацию.
Благодаря этой репутации мы провели на Kickstarter успешную кампанию по сбору средств на Queen's Wish: The Conqueror — потрясающую RPG, которая тоже будет выглядеть чудовищно. Мы надеемся, что она станет фундаментом для дальнейшего создания ужасно выглядящих игр.
Мы ни на что не жалуемся. Мы находимся на пике долгой и успешной карьеры, и всё просто чудесно. Однако иногда я люблю писать о бизнесе создания инди-игр, помогать людям понять его принципы, а также давать советы менее опытным разработчикам. Эта статья о том, почему наши игры выглядят именно так, нравится вам это, или нет (скорее всего, нет).
Самое главное заключается в том, что я хочу защитить право инди-разработчиков быть странными. Если у инди-разработчика появится безумная, творческая идея, и он испугается её реализовать, но подумает: «Это можно и сделать; по крайней мере, я не настолько сумасшедший, как Джефф Вогель», то я буду считать свою миссию выполненной.
Итак, если вам интересно, почему мы пишем игры, которые выглядят и ВСЕГДА будут выглядеть как куча навоза, то продолжайте чтение.
Дело не только в деньгах, или Как я поверил в видеонаблюдение как сервис
8 min
Привет, Хабр! Меня зовут Александр, много лет я ставил системы видеонаблюдения на коммерческих объектах и не доверял облачным сервисам по модели VSaaS (video surveillance as a service). Я был уверен, что серьезные бизнесы не экономят на проектах и выбирают традиционную систему видеонаблюдения по модели on-premise. А вот VSaaS нужен, если приходится втискиваться в бюджет здесь и сейчас.
Теперь я внедряю видеонаблюдение в облаке и чаще вижу ситуации, когда компания осознанно выбирает аренду как выгодный и удобный вариант. Сегодня на примере своих старых проектов я покажу, как в процессе эксплуатации локальной системы растет ее ценник и усложняется поддержка. После приведу расчеты, во сколько обойдется такая же система в облаке.
Теперь я внедряю видеонаблюдение в облаке и чаще вижу ситуации, когда компания осознанно выбирает аренду как выгодный и удобный вариант. Сегодня на примере своих старых проектов я покажу, как в процессе эксплуатации локальной системы растет ее ценник и усложняется поддержка. После приведу расчеты, во сколько обойдется такая же система в облаке.
Дисклеймер: все цены взял из проектов двухлетней давности. Если стоимость поменялась сильно, постарался обновить данные.
Бесполезное видеонаблюдение или принцип «Чабудо» китайских производителей
9 min
Бесполезное видеонаблюдение или принцип "Чабудо" китайских производителей. Почему интерфейс софта производителей IP камер остался в стиле девяностых?
Как не купить свою органику — гайд по инкрементальности в маркетинге
8 min
Tutorial
Каждый день компании теряют значимую часть бюджета на пользователей, которых получили бы и так, бесплатно. Представьте, что вы могли бы знать, какая часть маркетингового бюджета расходуется впустую, и сэкономить его.
В этой статье мы научимся это делать.
О чем поговорим в статье:
- Что такое инкрементальность.
- Как её рассчитать.
- Инкрементальность и атрибуция.
- Где чаще всего встречается инкрементальность.
75 лекций на русском от Y Combinator (из 172)
14 min
Патрик и Джон Коллинсон, основатели Stripe (в 22 года и в 21 год), с капитализацией $35 млрд.
Y Combinator — лучший в мире акселератор для стартапов по количеству единорогов (21), по объему привлеченных инвестиций ($27 млрд) и по капитализации выпускников ($155 млрд). Важно отметить еще то, что среди выпускников YC было несколько основателей моложе 18 лет (и один 20-летний из России).
А ещё Y Combinator выкладывает все свои учебные материалы бесплатно, уже более 10 лет.
Основатели и техдиры миллиардных стартапов Amazon ($1.55 трлн), Facebook ($720 млрд), PayPal ($127 млрд), AirBnb ($40 млрд), Pinterest ($38 млрд), Stripe ($35 млрд), LinkedIn ($26.2 млрд), Slack ($23 млрд), WatsApp ($19 млрд), Doordash ($16 млрд), Twitch ($15 млрд), Netscape ($10 млрд), Sun Microsystems ($7.4 млрд), Zenefits ($4 млрд), Segment ($4 млрд), Box ($2.76 млрд), Quora ($2 млрд), Asana ($1.5 млрд), Zappos ($1.2 млрд), Docker ($1.2 млрд), Pebble, Jawbone, Opsware, Weebly, Yahoo!Mail, Gmail, Mixpanel, Scribd и пр, а так же основатели венчурных фондов Andreessen Horowitz, Cowboy Ventures делятся своим опытом со всем миром. Это контент невероятного качества для тех, кто хочет играть в «высшей лиге», на международном уровне.
Сейчас у Y Combinator 172 видео-лекции в плейлистах: 2012, 2013, 2014 NY, 2014 Europe, 2014 SV, How to Start a Startup (2014 Lectures), 2016, 2017, 2018, Startup Investor School 2018, 2019, 2020. Ниже приведены переводы, субтитры и транскрипты 75 из них.
Как писать статьи в IT-журналы и блоги
17 min
Недавно на нашем ютуб-канале выступил Андрей Письменный, главный редактор Xakep.ru.
Письменный автор сотен статей, посвященных технологиям, науке и бизнесу. В роли редактора он помогал авторам обрести свой слог, оформлять идеи в связные истории.
В этом выступлении он поделится с вами опытом и приемами, которые пригодятся в работе с текстом о технологиях.
Делимся записью эфира и расшифровкой.