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

Роли и доступ

Один словарь на всё: пять ступеней, которыми описываются и роль в проекте, и точечный доступ к странице, и права ссылки, и режим документа.

Ступень Что добавляет к предыдущей
Чтение читать страницу и её обсуждение
Комментарий + комментировать
Предложения + предлагать правки; применяет их тот, у кого есть право писать
Изменения + править напрямую
Владение + управлять доступом

Переходной таблицы между «ролями» и «правами» нет по построению — это одна и та же шкала.

Роли в проекте

Роль Что может
Владелец полный доступ, управляет участниками и доступом к страницам
Редактор правит страницы, принимает и отклоняет предложения
Соавтор предлагает правки, применяет их редактор
Комментатор комментирует, но не меняет текст
Читатель только чтение

Ролей ровно столько, сколько ступеней, — шестой не появится. «Весь отдел комментирует регламенты, правит только владелец» и «стажёр предлагает, ведущий принимает» — это роли, а не настройка по каждой странице.

Только владельцу проекта видны разделы настроек «Шаблоны страниц», «Менеджеры паролей» и «Резервное копирование», пункт «Доступ» в меню страницы; только он переименовывает проект и меняет его описание и часовой пояс.

Доступ к отдельной странице

Роль действует на весь проект. Поверх неё владелец выдаёт грант на конкретную страницу — меню «⋯» над страницей → «Доступ». Грант действует на неё вместе со всем поддеревом, иначе доступ к разделу из тридцати страниц означал бы тридцать выдач. Уровни гранта называются так же, как роли: «Читатель», «Комментатор», «Соавтор», «Редактор».

Грант умеет только повышать уровень. Понижения не существует — не «пока нет», а нет как возможности: страница, видимая участнику проекта, видима ему всегда.

Это стоит сказать прямо, потому что от продукта такого класса часто ждут обратного. Причина в устройстве: ответ ассистента собирается из фрагментов текста, а не из страниц целиком, и «скрытая» страница рано или поздно вытекла бы цитатой в ответе — беззвучно, ответ выглядел бы нормальным. Обещать то, что нельзя выполнить надёжно, хуже, чем честно сказать: разграничение проходит по проектам. Нужно, чтобы часть команды чего-то не видела, — заведите отдельный проект.

Эффективный уровень на странице — максимум из роли в проекте и всех унаследованных грантов.

Срок

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

Режим документа

Что вы делаете со страницей прямо сейчас, выбираете вы сами — переключателем в строке над страницей: «Чтение», «Комментировать», «Предлагать правки», «Изменения». Выше эффективного уровня подняться нельзя, ниже — сколько угодно. У читателя переключателя нет вовсе: режим у него один.

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

Отсюда же ответ на вопрос «почему у меня нет пункта „Изменения“»: на этой странице ваш уровень — «Предложения», а «Изменения» следующая ступень.

Агент и ассистент

Агент в редакторе кода и ассистент в чате работают под вашим доступом: читатель, подключивший агента, получит агента-читателя, который ничего не предлагает. Правки, которые они предлагают, применяет человек с правом на правку — см. Проверка правок агента.

Кого можно позвать

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

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

Всё, что касается доступа: выдача гранта, смена уровня, отзыв, создание ссылки, повторный показ её секрета, отзыв ссылки, переход по ключу секрета. Запись переживает и гостя, и истёкшую ссылку. См. Журнал действий.