Многие компании в России столкнулись с ситуацией, когда привычные облачные сервисы прекратили работу, а данные оказались заперты в проприетарных форматах, которые без специальных инструментов не открыть.
Концепция «Файл вместо приложения», предложенная Стефаном Ангом, сооснователем Obsidian, предлагает решение: переместить фокус с инструментов на данные, обеспечив их доступность, долговечность и независимость от конкретного ПО.
Всем привет! Меня зовут Катя, я развиваю Open Source-платформу Gramax для управления технической документацией. В этой статье хочу обсудить, почему подход «Файл вместо приложения» набирает популярность, какие преимущества приносит бизнесу, а также как мы реализуем его в Gramax.
Почему концепция набирает популярность
Проблемы с облачными сервисами и проприетарным ПО становятся все заметнее. Ограничения доступа (например, к Atlassian в России) или изменения в политике конфиденциальности подталкивают к поиску устойчивых решений. Основные причины интереса к концепции:
Контроль над данными. Пользователи и компании хотят владеть своей информацией, а не зависеть от сторонних платформ. Локальное хранение исключает риск потери данных из-за внешних факторов.
Долговечность. Программное обеспечение устаревает, теряет поддержку или не работает на новых устройствах. Файлы в открытых форматах, таких как Markdown, читаемы десятилетиями, если хранятся локально или в управляемых репозиториях.
Совместимость. Данные в универсальных форматах (Markdown, JSON, CSV) открываются множеством инструментов, снижая зависимость от одного приложения.
Независимость от облака. Облачные сервисы требуют постоянного интернета и доверия к провайдеру. Локальные решения работают всегда, даже если сервера «легли» (а они любят это делать в самый неподходящий момент).
Рост Open Source. По данным GitHub Octoverse 2024, активность в Open Source проектах выросла на 60%, включая создание 70,000 новых публичных и Open Source AI-проектов. Это отражает спрос на автономные решения.
Популярность открытых форматов также подтверждается данными Stack Overflow Developer Survey 2024, где 29.1% разработчиков используют Markdown как асинхронный инструмент. Это подчеркивает, что Markdown становится стандартом для документации благодаря своей простоте и совместимости.
Почему бизнес выбирает self-hosted решения
Для IT-компаний концепция «Файл вместо приложения» — стратегический выбор. Основные причины:
Безопасность и конфиденциальность. Ужесточение законодательства, такого как ФЗ-152 в России или GDPR в Европе, требует минимизации передачи данных сторонним провайдерам. Выбирая self-hosted решения, бизнес контролирует, где физически хранятся данные, кто имеет к ним доступ и как они обрабатываются. Это снижает юридические риски и упрощает соответствие требованиям регуляторов.
Надежность. Локальные решения не зависят от внешних серверов, что критично для компаний с высокими требованиями к доступности. Self-hosted решение — это возможность контролировать отказоустойчивость и бэкапы без ожидания от внешнего вендора.
Гибкость. Self-hosted инструменты можно адаптировать под свои процессы: от интеграции с CI/CD до кастомных шаблонов. Такой подход, как правило, невозможен в закрытых SaaS-сервисах.
Независимость от вендора. Данные в открытых форматах позволяют мигрировать на другие платформы без потерь, устраняя риск vendor lock-in. Независимость — это свобода менять инструменты без страха потерять данные или тратить месяцы на миграцию. А значит, можно гибко менять архитектуру, не рискуя стабильностью или совместимостью.
Как мы это делаем в Gramax
Gramax — платформа для подготовки технической документации на базе подхода Docs as Code. В отличие от традиционных облачных сервисов (таких как Confluence, Notion или Google Docs), Gramax хранит текст в обычном Markdown, а версионирует его с помощью Git.
Локальное хранение в Markdown
В Gramax документация пишется в удобном визуальном редакторе, а сохраняется в Markdown-файлах. Они существуют локально на компьютере редактора или в Git-репозитории.
Долговечность. Markdown — открытый формат, читаемый любым редактором, от Notepad до VS Code. Через 20 лет твои данные не превратятся в «цифровую археологию».
Совместимость. Статьи открываются в Obsidian, Zettlr или обрабатываются скриптами (например, для анализа метаданных в Python).
Контроль. Данные принадлежат команде или компании, без зависимости от облачных провайдеров.
Markdown, конечно, не дает всей гибкости оформления сложных таблиц или ярких визуальных блоков ?
В Gramax мы расширяем его синтаксис — добавляем кастомные элементы для свободы оформления. Но также лояльно относимся к выбору других нотаций: например, можем хранить исходники в MDX и GitHub Flavored Markdown.
Но суть остается прежней: данные хранятся в обычных текстовых файлах, которые легко просмотреть в исходном виде и перенести в любую совместимую систему.
Интеграция с Git
Gramax использует Git для синхронизации и версионирования. Можно подключить GitHub, GitLab, Bitbucket, Gitea или любого другого провайдера.
Версионирование. Все правки фиксируются в Git. Ошибся? Откатывай. Нужен ревью? Делай запрос слияния.
Self-hosted. Портал документации разворачивается на своем сервере в виде статического сайта или Docker-контейнера. Никаких внешних зависимостей.
Коллаборация. Разработчики работают с Markdown в VS Code, аналитики — через интерфейс Gramax. Все изменения синхронизируются через Git.
Поддержка миграции
Gramax, ко всему прочему, делает упор на экспорт и переносимость данных:
Универсальный формат. Markdown-файлы легко экспортируются и импортируются в другие системы, что минимизирует риск vendor lock-in.
Экспорт в популярные форматы. DOCX и PDF на случай, если партнеры или заказчики не поддерживают «модное».
Импорт из популярных систем. Gramax помогает «вытащить» контент из Confluence, Notion и Yandex Wiki в Markdown. После импорта не обязательно использовать Gramax: можно просто сохранить все файлы в репозитории и просматривать в исходниках.
Простота перехода. Данные, хранящиеся в Git, можно перенести в другую систему, просто скопировав репозиторий, или использовать API для автоматизации миграции.
Предвосхищаем комментарий: «Gramax — коробка, это уже vendor lock» ?
Любую систему, на которую компания не имеет прав, можно охарактеризовать как vendor lock. Исходный код Gramax выложен в открытый доступ под лицензией GPL-3.0 license. Это означает, что Gramax можно дорабатывать под свои задачи.
Также в ближайшее время в Gramax появится механизм модулей — достаточно будет написать необходимую возможность и подключить ее в виде дополнительного модуля.
Инструменты для команд
Gramax предлагает функциональность, ориентированную на IT-команды, сохраняя при этом принципы «Файл вместо приложения»:
Шаблоны. Централизованные шаблоны в Git-репозитории упрощают создание однотипных документов (технических заданий, отчетов), сохраняя их в Markdown.
Свойства (properties). Метаданные для структурирования статей (например, статус задачи, дедлайн) хранятся в Markdown, что позволяет фильтровать и анализировать данные без привязки к платформе.
Интерактивные диаграммы. Поддержка визуальных редакторов для диаграмм снижает барьер для участников команды, не знакомых с синтаксисом Mermaid или PlantUML.
Если вы посчитали статью рекламой и приготовили минусомет ?
Как мы писали в статье «От Docs as Code к Everything as Code: как Gramax меняет работу с документацией» — у нас есть концептуальная идея о том, что мы можем сделать работу многих команд удобнее и легче.
Потому мы выложили Gramax в Open Source. При этом никак не отслеживаем (и не можем это сделать) использование Gramax.
Безопасность и автономия
Gramax не использует облачные бэкенды, что идеально для компаний с высокими требованиями к безопасности. Развертывание на своем сервере и хранение в Git соответствуют ФЗ-152 и GDPR.
Так чего, микротренд или..?
В России концепция «Файл вместо приложения» особенно актуальна из-за локальных реалий:
Санкции и уход вендоров. Закрытие доступа к некоторым облачным сервисам (например, Microsoft 365, Google Workspace) подтолкнуло компании к поиску self-hosted решений.
Законодательство. ФЗ-152 и требования к локализации данных заставляют бизнес искать инструменты, которые можно развернуть на своих серверах.
Open Source культура. Российские IT-команды активно используют Open Source инструменты, что делает Gramax и подобные решения привлекательными.
На глобальном уровне концепция «Файл вместо приложения» также набирает обороты:
Рост Open Source. Инструменты вроде Obsidian, Logseq и Zettlr показывают, что пользователи ценят независимость данных. Gramax вписывается в этот тренд, предлагая командную версию такого подхода.
Data sovereignty. В Европе (GDPR), США (HIPAA) и других регионах требования к конфиденциальности данных усиливают спрос на локальные и переносимые решения.
Файл вместо приложения — это философия: если вы хотите создавать цифровые артефакты, которые сохранятся надолго, они должны быть файлами, которые вы контролируете, в форматах, которые легко извлечь и прочитать. Используйте инструменты, которые дают вам эту свободу.
Прочитать полную цитату можно здесь.
Открыто, бесплатно, и с сообществом
Смотрите наш сайт — https://gram.ax
Вступайте в комьюнити — https://t.me/gramax_chat
Комментарии (6)
dyadyaSerezha
08.07.2025 09:14Только ближе к концу статьи написано, что же предлагает Gramax как платформа. А до этого - читаешь и не можешь понять: ну markdown, ну git, ну локальный репозиторий с документами, ну текстовые редакторы. Так это всё я и так имею или могу сделать. А что мне Gramax даёт? Непонятно. Потом, наконец, прояснилось, что есть экспорт/импорт и метаполя. Это всё? Ну допустим, все. Но с этого и надо начинать - с того, что даёт ваш продукт сверху к "git + редакторы". А то много слов вокруг да около, но ничего толком не понятно.
krakenkaken Автор
08.07.2025 09:14Для этой статьи выбрали категорию "Мнение", чтобы поразмышлять о концепции и ее профитах. И рассказать про Gramax ТОЛЬКО с точки зрения концепции.
Про сам Gramax писали в других статьях, например:
От Docs as Code к Everything as Code: как Gramax меняет работу с документацией
Передаем документацию заказчику: Markdown, Git, CI/CD и почти полная автоматизация
Ну и всегда рады поболтать в комментариях или личных сообщениях:)
dyadyaSerezha
08.07.2025 09:14Спасибо, но эти ссылки лучше дать сразу после заголовка "Как мы это делаем в Gramax".
outlingo
За осознание правильности концепции "плюс" а за голимый LLM-ный маркетвыхлоп "минус"
krakenkaken Автор
Даже не знаю, радоваться или грустить...
Если статью называют "голимым LLM-ным маркетвыхлопом" — это значит что статья слишком хорошо оформлена, либо недостаточно глубины материала.
Как пруф могу показать промежуточные версии:
Помогите сделать работу над ошибками: как думаете, что убрать, что добавить?