Аналог Confluence

Confluence хранит документацию страницами в пространствах. В Skillok документация — это markdown-файлы в репозитории, и с ней работают как с кодом — правка, история, ревью. Это строже и прозрачнее, но без визуального конструктора страниц и совместной правки в реальном времени.

Обновлено
В этой статье

Как выглядит документация в Skillok#

  • Раздел документации — папка, страница — markdown-файл. README в корне
    репозитория показывается на его главной странице — удобное оглавление.
  • Разметка: заголовки, таблицы, списки задач, выноски > [!NOTE], формулы,
    диаграммы Mermaid, код с подсветкой, ссылки между страницами.
  • Правка прямо в браузере или локально в любом редакторе с отправкой через git.
  • У каждой страницы — полная история: кто, когда и что изменил, с
    возможностью открыть любую прежнюю версию.

Ревью документации#

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

Доступ#

Документацию команды держи в закрытом репозитории организации. Доступ
выдаётся командам и людям с ролями: только просмотр, разбор задач, правка,
сопровождение. Публичную документацию — в открытом репозитории.

Чего нет#

  • визуального редактора страниц с макросами и встраиваемыми блоками;
  • совместной правки одной страницы в реальном времени;
  • комментариев прямо к строке текста в интерфейсе;
  • поиска по содержимому документов — только поиск файла по имени внутри
    репозитория;
  • импорта пространств Confluence.

Как перенести#

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

Кому подходит#

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

Попробовать на своей задаче

Создай репозиторий — история изменений, задачи и запросы на слияние будут с первого дня.

Создать репозиторий

Было полезно?

Ещё сценарии

Аналог GitHub Skillok устроен как GitHub и повторяет его привычные вещи — репозиторий, коммиты, ветки, задачи, запросы на слияние, проекты, организации. Интерфейс на русском и английском. Ниже честно — что уже есть, чего пока нет и как перенести свой код за несколько минут. Аналог Trello Trello любят за простую доску — колонки и карточки. В Skillok доска есть в каждом проекте, карточки перетаскиваются между колонками, а у карточек-задач появляются метки, исполнители, сроки через свои поля и связь с файлами и кодом. Аналог Jira Jira умеет почти всё, и за это её часто не любят небольшие команды — слишком много настроек ради простого «что делаем, кто делает, что готово». В Skillok задачи и доски устроены проще, по образцу GitHub — и живут рядом с кодом и документами. Аналог Notion Notion — это страницы-конструкторы и базы данных. Skillok устроен иначе — заметки лежат обычными markdown-файлами в репозитории, и у каждого изменения есть история. Если тебе важны текст, порядок и возможность в любой момент забрать всё с собой, это может быть удобнее. Если нужны таблицы-базы с формулами и совместная правка в реальном времени — нет. Аналог GitLab Если GitLab нужен тебе ради репозиториев, задач и ревью кода, а поддерживать свой сервер не хочется, Skillok закрывает эту часть. Если же ты живёшь в GitLab CI и реестре пакетов — честно говоря, это пока не про нас. Разберём, что совпадает и что нет. Аналог Obsidian с синхронизацией Хранилище Obsidian — это папка markdown-файлов. Её можно положить в git-репозиторий на Skillok и получить синхронизацию между устройствами, историю каждой правки и просмотр заметок в браузере — со ссылками между заметками, выносками и тегами.

Ещё темы

Школьная математика Задачи на проценты 6 класс Процент — это сотая доля: 1 % = 0,01. Почти все школьные задачи на проценты сводятся к трём типам, и каждый решается одним действием, если правильно определить, что в условии принято за целое. Как учиться Выгорание Эта статья — не о здоровье и не о том, как поставить себе диагноз. Она о рабочих и учебных условиях, при которых силы уходят быстрее, чем восстанавливаются, и о том, что в этих условиях можно изменить самому. Всё, что касается состояния организма, решает врач или психолог, а не текст в интернете. Как учиться Тайм-менеджмент Управление временем не добавляет часов в сутки. Оно решает другую задачу — сделать выбор осознанным: что ты делаешь сейчас, что позже, а чего не будешь вовсе. Ниже — техники, которые переживают столкновение с реальной неделей, и границы каждой.