Habr.com

Ленты новостей Хабр
URL-адрес: https://habr.com/ru/all//
Обновлено: 16 мин. 13 сек. назад

[Перевод] Откровения кофеин-зависимого инженера: как писать документацию

пт, 06/11/2021 - 22:52

Четыре вида документации распределнные по двум осям: практика-теория и обучение-работа.

Недавно вышли два нашумевших поста:


И многие спрашивали: «Кто-нибудь, пожалуйста, научите меня писать хорошую документацию».
Я не претендую на звание эксперта, но думаю, что хорошо с этим справляюсь.

Я выпил достаточно кофе, и я попытаюсь объяснить то, что знаю.

TL; DR: пишите документацию для решения конкретной проблемы для определенной группы людей, а не только для того, чтобы документация была.

Пишите хорошо
Во-первых, вам нужно уметь хорошо писать. Автор «пьяных откровений» явно уже опроверг это утверждение, но для большинства это может не сработать. Вы должны уметь брать темы и выискивать основную суть, показать ключевые детали. Эти детали нужно правильно упорядочить, а затем перевести в четкие предложения.

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

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

Виды документации
Ладно, теперь вернемся к документации. Читать дальше →

Видеокарты продолжат дорожать: накрутка при помощи посредников, нехватка мощностей и геймеры

пт, 06/11/2021 - 21:48

О том, что чипы и «железо» продолжает дорожать, на Хабре писали не раз и не два. И действительно, дорожают чипы памяти, видеочипы и даже жесткие диски с SSD. Сначала причиной были майнеры, сейчас они продолжают поддерживать стабильный спрос на все, что может им пригодиться.

Но по данным экспертов, в последнее время на рост цен влияют далеко не только они. Насколько можно понять, в ближайшем обозримом будущем ни старые, ни новые модели карт дешеветь не будут. Напротив, цены идут только вверх. Почему?
Читать дальше →

[Перевод] Как образуются астрофизические кротовые норы и как мы можем их наблюдать

пт, 06/11/2021 - 20:00

Червоточины, кротовины или кротовые норы (англ.: Wormholes) — это гипотетические пространственно-временные структуры с нетривиальной топологией, соединяющие либо две области одной вселенной, либо две разные вселенные. Входы в червоточину называются "устьями", а область между "устьями" именуют "горлом".

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

В данном материале будут рассмотрены основные методы поиска макроскопических проходимых червоточин. Сначала будут описаны основные механизмы формирования и стабильности проходимых кротовых нор, затем будут рассмотрены сами методы их поиска и наши успехи, связанные с этими методами.

Читать далее

[Перевод] Пара мыслей о геттерах и сеттерах в C++

пт, 06/11/2021 - 19:49

Эта статья посвящена геттерам и сеттерам в C++. Приношу свои извинения, но речь пойдет не о корутинах. К слову, в ближайшее время появится вторая часть про пулы потоков.

TL;DR: геттеры и сеттеры не очень хорошо подходят для структуроподобных объектов.

Читать далее

Ускорение проектирования РЧ-, СВЧ-устройств (4/5)

пт, 06/11/2021 - 19:34

РЧ-, СВЧ-платы являются одним из самых быстрорастущих секторов в производстве печатных плат. С увеличением количества датчиков IoT, беспроводной электроники и смартфонов легко понять, почему. Но как узнать, работаете ли вы с РЧ или СВЧ-платой? Индустрия печатных плат считает, что любая плата, работающая на частоте выше 100 МГц, является РЧ-платой. Все, что приближается к 2 ГГц, является СВЧ.
Читать дальше →

Дайджест релокейта: 5 стран для переезда IT-инженера или фрилансера

пт, 06/11/2021 - 18:31

В нашем блоге мы регулярно собираем истории россиян и жителей стран СНГ, которые переехали работать за границу. Собрали 10 таких историй в дайджест, чтобы кратко рассказать особенности этих стран, плюсы и минусы жизни и условия переезда.


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




Читать дальше →

We need to go deeper: как пасхалка в приложении Delivery Club сократила субъективное время ожидания еды

пт, 06/11/2021 - 18:19


Мы знаем, что ожидание заказа часто бывает утомительным, особенно когда очень хочется кушать. Мы пристально следим за пользовательским опытом, но над временем не властны и сократить ожидание ниже объективного минимума не можем.

В декабре у нашего разработчика Александра Верестникова возникла идея интегрировать в приложение тайм-киллер — игру-пасхалку, в которую пользователь мог бы поиграть, пока ждёт заказ. Игрушка позволила бы сократить субъективное время ожидания заказа, а тот факт, что её как будто сложно найти, добавил бы происходящему таинственности. Саша зацепил этой идеей другого разработчика, Сахея Игнатьева. И они принялись за работу. После недолгих обсуждений выбор пал на змейку.
Читать дальше →

Проект электронного мультитула QUARK. Часть 2

пт, 06/11/2021 - 18:18

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

Читать далее

Сортируем файлы с помощью Python

пт, 06/11/2021 - 18:17

Штош. Скорее всего, у многих в папке загрузок собиралась куча разных инсталляторов, архивов и прочих файлов. И вот наступает момент, когда из этой кучи экскрементов нужно найти какой-то файл. Вот я и подумал, почему бы не написать скрипт сортировщика по расширениям файлов на Python?

Действительно

Июньские заметки о виртуальной реальности. Часть 3

пт, 06/11/2021 - 18:17
Часть 1
Часть 2


Позиционирование, трэкинг. Full body tracking. Решения и цены
Основное, что нужно знать.

Всё, что вы можете получить, используя Oculus Go, Google Dream, Samsung Gear или мобильный телефон вложенный в шлем — это 3DoF, вращение головой. То есть вы не сможете перемещаться в пространстве, двигаясь вперед, в шлеме вроде Oculus Go. У “полноценных” шлемов типа HTC или Quest 2 куда больше степеней свободы:



Кроме того, есть внутренний трекинг (использующий камеры на шлеме) и внешние маяки (LightHouse или так называемые базовые станции) с трекерами. Также есть камеры глубины типа кинекта и обычные камеры, считывающие маркеры/ir-светодиоды.

Подробнее о принципах FBT можно почитать в этих статьях: раз, два.

Чем хорош и интересен Full Body Tracking?
Лично меня он заинтересовал после просмотра видео, где блогер использует пинки в игре Blade and Sourcery:
Читать дальше →

Как я ускорил движок на 13%

пт, 06/11/2021 - 18:04

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

[Перевод] Стаи рыб следуют алгоритмам композиционного обучения

пт, 06/11/2021 - 17:25

Группа животных — это больше, чем сумма всех членов группы. Поведение одинокого муравья трудно назвать осмысленным, но их колония способна построить прочную и хорошо вентилируемую муравьиную кучу. Одинокий журавль может легко заблудиться в небе, но стая журавлей безошибочно выбирает правильный путь миграции. Во многих сложных когнитивных процессах мы регулярно наблюдаем отличия в поведении группы от поведения её отдельных членов. Как это возможно? Даже автор статьи, кандидат наук, не может понять, как примитивные рыбы — золотые нотемигонусы, абсолютно безмозглые существа, собираясь в стаи, способны эффективно уклоняться от хищников. Автор прочитал десятки статей и учебников, проводил эксперименты, анализировал данные и консультировался с теоретиками, пытаясь понять, почему, когда речь идёт о рыбах, 1 плюс 1 получается не 2, а 3.

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

Читать далее

Ученым удалось полностью объяснить природу полярных сияний

пт, 06/11/2021 - 17:01


Вид развевающихся в небе полярных сияний издревле зачаровывал людей. Десятилетиями учёные ограничивались теоретическими обоснованиями возникновения данного феномена, однако в рамках нового исследования физики наконец сумели экспериментально доказать корректность существующих теорий. В частности, исследователи подтвердили причастность к образованию полярных сияний альвеновских волн, возникающих в магнитосфере Земли во время геомагнитных бурь.
Читать дальше →

[Перевод] StreetWriter: собираем устройство для печати водой по асфальту

пт, 06/11/2021 - 17:00


В мануале мы расскажем, как собрать достаточно любопытное устройство с большим потенциалом, которое позволяет наносить различные надписи на асфальт, во время движения. Всё в мире иллюзорно и временно… И данный проект хорошо иллюстрирует это.




Вступление
Я начал заниматься этим проектом, потому что хотел оставить свой след в мире, но не хотел оставлять никаких последствий.

Я также хотел сложного проекта для моего нового 3D-принтера, который включал бы программирование для Arduino.

Наконец, мне нравится создавать вещи, используя как можно больше имеющегося в наличии добра.

Как можно увидеть в моих видео, StreetWriter соответствует всему этому. Он пишет сообщения высотой 8 дюймов (20,32 см) водой на тротуаре, во время движении и не оставляет следов, когда вода испаряется.

Я построил два StreetWriter-а с небольшими различиями в конструкции между ними. Эта инструкция основана на второй сборке, которая несколько улучшена.

В StreetWriter-е вода под давлением подается в коллектор, в который содержит 8 автомобильных топливных форсунок. Во время движения StreetWriter-а — Arduino управляет топливными форсунками, разбрызгивая воду на тротуар. Наносимое сообщение является одним из 8, которые были записаны на SD-карту, подключенную к Arduino. Оператор может легко выбирать среди сообщений и может записывать новые сообщения на SD-карту, с помощью компьютера. Нет ограничений на длину сообщения, кроме количества воды в резервуаре. Самое длинное сообщение, которое я написал на данный момент — число Пи, с точностью до 300 знаков.
Читать дальше →

[Перевод] Чему я научился, проработав два года разработчиком ПО в Microsoft

пт, 06/11/2021 - 16:40

Так как завершается второй год моей работы разработчиком ПО в Microsoft India, логично будет порассуждать о том, чему же я научился за последние два года.

Я пришёл в Microsoft сразу после учёбы в колледже, Indian Institute of Technology Guwahati, и эта работа стала моим первым опытом. Со временем я очень сильно вырос и получил множество новых уроков. В этой статье я постараюсь структурировать свои мысли о них.

Итак, вот пять вещей, которым я научился.

1. Исследования, исследования и снова исследования
«Общепринятые сегодня факты являются результатами вчерашних исследований», — Дункан Макдональд
Когда я говорю «исследования», то подразумеваю два значения:

Проведение исследований для выявления первопричины проблемы.

Я почти сразу понял: очень легко выработать привычку не вдаваться в подробности проблемы и не понимать её истинные причины. А если вы не знаете конкретной причины существования проблемы, это почти всегда сказывается, когда вы уже почти решите задачу. «Почти» — очень важное здесь слово.

Проведение исследований для нахождения самого эффективного решения текущей задачи.
Читать дальше →

Как мы делаем корпус Flipper Zero безупречным

пт, 06/11/2021 - 16:18

Flipper Zero — проект карманного мультитула для хакеров в формфакторе тамагочи, который мы разрабатываем. Предыдущие посты [1],[2],[3],[4],[5],[6],[7],[8],[9],[10],[11],[12],[13],[14],[15]

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

Сегодня я расскажу вам о найденных и исправленных проблемах при производстве первых партий корпусов Flipper Zero, изготавливаемых литьем под давлением.

Читать далее

Rust — сохраняем безразмерные типы в статической памяти

пт, 06/11/2021 - 16:12

Не так давно в качестве хобби решил погрузиться в изучение embedded разработки на Rust и через какое-то время мне захотелось сделать себе логгер, который бы просто писал логи через UART, но который бы при этом не знал какая конкретно реализация используется. И вот тут я быстро осознал, именно в этом конкретном случае я не могу полагаться на статический полиморфизм и мономорфизацию, ведь компилятор не знает сколько нужно памяти выделять под конкретную реализацию. Фактически это означает, что нам нужно как-то уметь сохранять типы, размер которых неизвестен на этапе компиляции, и такой способностью обладает тип Box и для решения этой проблемы как раз и возникла идея написать свой аналог типа Box, но который сохраняет обьект не в куче, а в предоставленном пользователем буфере.

Читать дальше

А что бы сказал Линус: приветствуем победителей первой хабрапремии Corp Blog Awards

пт, 06/11/2021 - 15:03
Недавно мы объявили лучших в рамках премии Corp Blog Awards, на которую могли претендовать корпоративные блоги, делающие крутой хабраконтент. Мы уже торжественно вручили им памятные призы и чемпионский пояс. Но материальные награды — не главное.



Мы решили особо поприветствовать лучших из лучших в каждой номинации, а заодно объяснить, в чём и почему они отличились. Делать это мы будем не в одиночку. Нам помогут видные эксперты в разных отраслях: люди, которые действительно знают, о чём говорят, и авторитету которых Хабр всецело доверяет — от основателя PayPal до отца интернета.
Читать дальше →

[Перевод] Проект VG64: добавляем второй монитор к Commodore 64

пт, 06/11/2021 - 14:48

После появления идеи добавления второго дисплея к Commodore 64 я довольно быстро реализовал этот проект. Все «железо» уместилось в картридж стандартного размера (вместе с коннектором DE-15). Видеовыход совместим с VGA (31 кГц).

Внутри картриджа — 128 КБ SRAM для кадрового буфера и простой 1-битный ЦАП.
Читать дальше →

Архитектура in-memory СУБД: 10 лет опыта в одной статье

пт, 06/11/2021 - 14:35


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

В статье я рассуждаю об архитектурных принципах решений в оперативной памяти. Как можно взять лучшее от in-memory мира — производительность невероятного уровня — и не жертвовать достоинствами дисковых реляционных систем. В первую очередь, надежность — как можно быть уверенным в сохранности данных.

Этот рассказ сжимает 10 лет опыта работы с in-memory решениями в один текст. Порог входа максимально низкий. Чтобы получить пользу от прочтения, вам не нужно иметь столько же лет опыта, достаточно базового понимания IT.
Читать дальше →

Сейчас на сайте

Сейчас на сайте 0 пользователей и 0 гостей.