| Date | Title | Description |
| Sign up to see | Sign up to see | Sign up to see |
| Mar 23, 2026 | Техпис на зоне: нужна ли свобода при написании документации | Документацию можно готовить где угодно и как угодно. Писать инструкции в многочисленных CCMS, публиковать сайты через генераторы наподобие Sphinx, применять сложные разметки вроде DITA, вести базы знаний в Confluence или вообще собирать фай... |
| Mar 7, 2026 | Docs as Code: документация, которая живёт вместе с кодом | Это перевод статьи с opensource.com, которая мне показалась особенно полезной и практичной, поэтому решил поделиться адаптированной версией для русскоязычной аудитории. Оригинал доступен по ссылке: https://opensource.com/article/22/10/docs-... |
| Feb 28, 2026 | Декораторы в Python для самых маленьких и немного для взрослых | Введение. Зачем вообще нужны декораторы?
Представьте типичную ситуацию: вы написали отличный кусок кода. У вас есть десяток функций, которые делают полезную работу — например, ходят в стороннее API, парсят данные и аккуратно складывают их в... |
| Jan 23, 2025 | Docs-as-Code в технической документации: переход от reStructuredText к AsciiDoc | Хабр, привет! На связи коллективный разум технических писателей компании «Базис». Над представленным в этой статье проектом мы работали вместе, так что и рассказывать о нем будем вместе. Если точнее, расскажем о том, как познавали методолог... |
| Dec 11, 2024 | Проверяем текст: кейс автоматизации с линтером Vale | Привет, на связи Марина и Катя (@lieutkat) — технические писатели Cloud.ru. За четыре года наша команда составила больше 30 правил по написанию технической документации и… прочувствовала на себе весь масштаб усилий на проверку и запоминание... |
| Dec 5, 2024 | Результаты большого техписательского опроса, часть 3. Документационный инструментарий, Docs as Code, зарплаты | С вами Семён Факторович и компания documentat.io. Продолжаю делиться результатами большого техписательского соцопроса, который мы проводили в начале 2024 года.
О том, кто такие русскоязычные техписатели, где они живут и сколько получают, чи... |
| Jul 29, 2024 | Тысяча и одна библиотека С++ | В жизни каждого программиста С++ рано или поздно возникает задача, которую кто-либо уже решил. Однако найти это решение бывает очень непросто в силу разных причин: оно недостаточно разрекламировано, либо имеет нечеткую документацию, или воз... |
| May 21, 2024 | Создаём безукоризненную автодокументацию кода на Python с помощью Sphinx | У дата-сайентиста множество обязанностей в каждом проекте, но именно подготовку документации он чаще всего оставляет на последний момент. Возможно, вы добросовестно пишете строки документации для классов и функций (молодцы!), но достаточно ... |
| May 14, 2024 | Разработка документации в продуктовой IT-компании с нуля | Всем привет, на связи Дмитрий (Architecture & Development Director) и Дарья (Head of Technical Writing). В этой статье речь пойдет о том, как мы создавали портал технической документации в Arenadata.
В качестве основного ресурса докумен... |
| Mar 20, 2024 | Превратите свой пет-проект из хобби в карьеру | Привет, Хабр!
Меня зовут Данил Картушов, в этом посте я расскажу, почему и как именно pet-project'ы могут стать ключом к вашей карьере.
Надеюсь, что после этого поста ты сможешь раскрыть свой потенциал к обучению и по-новому взглянуть на пр... |
| Mar 14, 2024 | Sphinx для автодокументирования на проекте | Sphinx был разработан 21 марта 2008 года, и является генератором документации в Python. Сам он так же был написан Python и преобразует файлы reStructuredText в HTML-вебсайты и другие форматы, включая PDF, EPub, Texinfo и man. Sphinx позволя... |
| Dec 19, 2023 | Никогда не забывай об этом, когда делаешь open-source проект | Если составлять топ самых крутых изобретений человечества, то второе место сразу после кофеварки наверняка займёт open-source – разработка проектов с открытым исходным кодом, которая помогла родиться поистине огромному числу полезных и гени... |
| Oct 17, 2023 | Создание системы документирования, или как в Cloud.ru от «ворда» к docs as code за месяц переходили. Часть 2 | Привет, Хабр! На связи снова Юрий Никулин. В первой части статьи я рассказывал, почему в Cloud.ru решили перейти на doc as code и какой технологический стек мы выбрали. В этой части поделюсь самим процессом — расскажу, как настраивали, тест... |
| Aug 16, 2023 | Блокировка Trello и Jira? Ничего страшного, поднимаем свой сервер | Redmine и Plane — опенсорсные альтернативы Jira на своём хостинге
Компания Atlassian в рассылке для пользователей предупредила, что все аккаунты в России и Беларуси будут принудительно отключены. Клиентам дают 30 дней на перенос своих данны... |
| Jul 28, 2023 | Создай, оформи, опубликуй. Sphinx — незаменимый помощник в мире Python документации | Привет, Хабр!
Меня зовут Рожнев Андрей, участник профессионального сообщества NTA.
В данной статье пройдём путь от знакомства с мощным инструментом для документации Sphinx до публикации нашей собственной документации на GitHub Pages. Мы узн... |
| Jan 31, 2023 | Скучный Python: качество кода | Это статья о том, как максимально скучно разрабатывать и выпускать приложения на Python. В прошлой статье я пояснил, что имею в виду под определением «скучный», давайте напомню: я не имею в виду «надежный», «без багов или «без инцидентов». ... |
| Nov 18, 2022 | Учимся создавать пакеты Python | Почему важно уметь создавать пакеты Python?
• Пакеты легко устанавливаются (pip install demo).
• Пакеты упрощают разработку (Команда pip install -e устанавливает ваш пакет и следит за тем, чтобы он сам обновлялся в ходе всего процесса разра... |
| Oct 6, 2022 | Как оставаться программистом, если у тебя память как у дрозофилы | Мой мадригал тем инструментам разработки, которые изменили мою жизньПрограммирование: срез за много лет
Программирование стало гораздо более многогранным ремеслом с тех пор, как в середине 1990-х я впервые попробовал AmigaBASIC. В те времен... |
| Apr 16, 2022 | 8 проектов с открытым исходным кодом | Представляю несколько проектов с исходным кодом начиная от инструментов для повышения производительности до B2B приложений. Решения можно использовать как замену платным.Chatwoot
Лицензия: Часть компонентов MIT Expat, есть проприетарные лиц... |
| Nov 22, 2021 | Как выбрать свой Static Site Generator — Новая документация Docsvision ч.1 | Привет всем читающим! Меня зовут Владимир, я - технический писатель в компании Docsvision. Я создаю документацию для нашей «Платформы по управлению процессами и данными для крупного бизнеса и госкомпаний». Это как СЭД, только лучше (C).
Я х... |
| Sep 21, 2021 | Построение архитектуры проекта при работе с PySpark | В настоящее время уже сложно найти крупную компанию, которая не использовала бы возможности накопления и использования больших данных. Меня зовут Никита Сурков и я работаю в проекте ценообразования "Пятёрочки" X5 Group. Проект явл... |
| Aug 12, 2021 | Как закалялась документация | Подобно безумному исследователю, я вот уже пятый год пытаюсь создать идеальную продуктовую документацию. Но, раз она всё еще не идеальна, значит я что-то делаю не так. Вот про это и будет статья.
Хочу очертить тот путь, который мы прошли, и... |
| AsciiDoc как стандарт для подготовки документации | Ключевым фактором для по-настоящему массового продукта является простота использования, функциональность и стоимость. Как принципиальный сторонник бесплатного ПО я являюсь давним пользователем технологии АsciiDoc и считаю, что на сегодняшни... |