Документация

Доступ по ссылке

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

Ссылка выдаётся на страницу — вместе с её поддеревом. Выдаёт её владелец проекта: меню «⋯» над страницей → «Доступ» → «+ Создать ссылку». Адрес у неё свой, вида /s/{секрет}: идентификатора проекта в нём нет, гость не знает и не должен знать, куда он попал. Ссылке можно дать название — чтобы потом помнить, кому её отправляли.

Два вида ссылок

С требованием входа (флажок «Требовать вход», стоит по умолчанию). Переход ведёт на форму входа, и до входа не показывается ничего — ни текст, ни название страницы, ни имя проекта. После входа ссылка превращается в персональный доступ к странице для этого человека, со сроком самой ссылки. Участником проекта он от этого не становится, но правки и комментарии подписаны его именем, а отзыв доступа адресный.

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

Без требования входа. Страница открывается сразу и только на чтение. Уровень выше не выдаётся: комментарий, которому нельзя переспросить автора, — не обсуждение, а правку от «гостя по ссылке» на экране проверки нечем взвесить. Нужен отзыв внешнего человека — дайте ссылку с входом, это один клик.

Это стоит сказать прямо: сценарий «оставь пометку, не заводя учётки» закрыт сознательно. Имя под правкой стоит дороже, чем сэкономленный клик.

Срок и отзыв

Срок ссылки — 7, 30 или 90 дней или «Бессрочно». После срока ссылка отвечает «Доступ к документу истёк». Отзыв мгновенный: отозванная ссылка перестаёт работать, включая уже открытые вкладки — подписанных адресов «с запасом» в системе нет.

Секрет ссылки можно посмотреть ещё раз — отдельным действием и только владельцу проекта. Каждый такой показ пишется в журнал: это не чтение списка, а повторная раздача доступа.

Что видит гость

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

Публичный сайт документации — это другое

Открытая наружу документация (например, docs.hivelore.ru) работает не ссылкой, а отдельным режимом: проект объявляется публичным в настройках контура, и наружу открываются только читающие ручки и только для запроса без входа. Ссылку-секрет для этого не используют: её можно по неосторожности отозвать и погасить этим всю документацию.

Что пишется в журнал

Создание ссылки, повторный показ секрета, отзыв и вход по ней. Запись переживает и гостя, и истёкшую ссылку. Открытия страницы гостем в журнал не идут — это поток без имени; на вопрос «пользуются ли ссылкой» отвечают счётчик и дата последнего использования на самой ссылке.