О Recenza

Привет! Вы читаете первый блог на Recenza — платформе многоглавных девблогов, где каждая статья проходит редакционное ревью до публикации.

Что такое Recenza

Recenza — это место, где технические статьи публикуются сериями глав: блог растёт со временем, как хорошая книга. Прежде чем глава попадёт к читателю, её проверяют ревьюеры — люди с подходящими навыками.

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

В следующих главах — подробнее о миссии и о том, что умеет каждая роль.

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

Мы верим, что у технической статьи должен быть не только автор, но и рецензенты — как у научной публикации.

Качество выше скорости

Recenza сознательно замедляет публикацию: глава выходит только после того, как все приглашённые ревьюеры её одобрили. Взамен читатель получает текст, за которым стоит не одно имя, а команда.

Ревьюеры указываются на каждой опубликованной главе — репутация проверяющих работает на доверие к материалу. История версий сохраняется: видно, как статья менялась от ревизии к ревизии.

Читать Recenza можно без аккаунта. С аккаунтом читателя появляются инструменты участия:

• Голоса — поднимайте полезные главы выше; один голос на главу, его можно отозвать.
• Закладки — личная коллекция блогов, доступна из меню аватара.
• Подписки — следите за автором: уведомление о новой главе придёт в колокольчик.
• Комментарии — обсуждение под каждой главой.

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

Авторский кабинет строится вокруг блогов и глав. Внутри — блочный редактор, писать в котором можно не отрывая рук от клавиатуры.

• 12 типов блоков: текст, заголовки, цитаты, списки, код с подсветкой, callout-врезки, таблицы, изображения, embed, схемы Mermaid и формулы LaTeX.
• Markdown-шорткаты в начале строки (## , > , - , `) и слэш-меню по «/».
• Инлайн-разметка выделением: жирный, курсив, код, ссылки.

Путь главы к читателю

Готовую главу автор отправляет на ревью: указывает ключевые навыки статьи и приглашает ревьюеров, чьи компетенции совпадают. Ревью начинается только после согласия ревьюера — ответ приходит сразу.

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

Ревьюер — отдельная роль со своим кабинетом. Ревьюеры не ведут блоги и не пишут публичные комментарии: их работа — качество чужих статей.

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

После публикации автор приватно оценивает работу ревьюера. Наружу выходит только агрегат — он влияет на позицию в подборе «Топ»: навыки 50%, рейтинг 30%, объём 20%.