Post #858

Последний рубеж. Нет это не про последний рабочий день в году. 🤔 Это про справочный раздел в продукте. Он должен быть таким местом куда идут если не сработал интуитивный интерфейс, онбординг и подсказки. Крупные игроки вроде GitHub, Stripe или Vercel делают справку отдельным сервисом и на это есть веские причины. Самое сложное в справке - поддерживать ее в актуальном состоянии. Если сделать ее отдельно, то можно спокойно вносить изменения и релизить, независимо от продукта. Однако, есть и обратная сторона монеты. Придется бороться с желанием некоторых участников команды, вместо того, чтобы сделать нормально, просто вкорячить очередную инструкцию 🏎 Если вы делаете такой раздел у себя, то крайне советую показать вашим фронтам vitepress или mkdocs. Почему их? Они хранят страницы в маркдауне. Их легко редактировать, они кастомизируемы, быстрые и лёгкие. А ещё, они бесплатные и опенсорсные