Чем различаются записи, сообщения и документы
- Документы это записи, предназначенные для фиксации тематической информации, обладающие следующими признаками: наличие версий документа, npj адрес в виде ИмениДокумента
- Сообщения это записи, предназначенные для фиксации периодической информации, привязанные к дате создания.
- Записи это любой из двух вышеперечисленных феноменов
- Комментарии — это вообще не записи, они гораздо более подчинённая и мелкая часть контента, подробнее — Почему Комментарий Не Запись?
Далее рассматриваются различия:
1. Предназначение
- Документы предназначены для работы над крупными текстами не теряющими свою актуальность в течении долгого периода, после создания. Например, это создание статей, концепций, проектной документации и других важных документов. Наличие версий и гибкая система настроек прав доступа предоставляет удобные возможности групповой работы над любым документом.
- Сообщения предназначены для общения. Например, с их помощью можно организовывать обсуждения каких-то тем, привлекать внимание своих читателей к какому-нибудь документу, или просто общаться в сообществах. До некоторой степени можно говорить о сходстве сообщения и топиков форума. Сообщения не обладают версиями и могут быть отредактированы после создания только своим автором. Мы иногда называем сообщения постами или постингами.
2. Настройки доступа
Управление доступом к сообщениям и документам устроено двумя разными способами. Это связано с повышенными требованиями к производительности при отображении сообщений.Сообщение, доступное для просмотра всем посетителям, называется публичным сообщением.
Каждому непубличному сообщению можно назначить до четырёх групп доступа из созданных вами групп конфидентов. Доступ к документам задаётся с помощью списков доступа (ACL).
Подробнее о различиях вы можете прочитать в Ноде::ДокументацияПользователя/УправлениеДоступом?.
3. Формирование URLа
Адрес (URL) к документам и сообщениям формируется по разному принципу.- Адрес сообщения генерируется автоматически, добавляя случайное значение к номеру предыдущего сообщения. Адрес сообщения — всегда число.
- Адрес документа автору придётся задать самому, зато документ можно будет найти именно по этому, заранее известному адресу. Этот адрес, к тому же, будет нести и смысловую нагрузку, что поможет его продиктовать по телефону и запомнить. Для удобства читателей и самого автора стоить помнить, что хороший адрес = короткий и понятный адрес.
4. Сохранение всех версий
После каждого редактирования документа его предыдущая версия сохраняется в архив, где может быть просмотрена (например,
!/Versions — архив версий этого документа). Версии можно сравнивать между собой и возвращать документ к любой из версий. С сообщениями так поступать нельзя.5. Расположение в журнале
Сообщения и документы находятся в разных местах вашего личного пространства.- Сообщения вы можете найти с помощью «лент» (feed) и с помощью календаря
- Документы вы можете найти в каталоге (index) или воспользоваться списком изменений (changes).
Хозяйке на заметку
Страница, расположенная «в корне» вашего журнала (ВашЛогин@npj) — это тоже документ, со всеми описанными свойствами и возможностями. То, что вы видите по этому адресу, если ещё ни разу не заглядывали внутрь, является результатом вызванного из документа Действия ( Feed ).
6. Разновидности сообщений и документов
У сообщений и документов есть разновидности, с которыми вы уже наверняка сталкивались.- Анонсы — это разновидность сообщений. Это более важные сообщения, или сообщения, формируемые на основе документов (анонсы документов)
- Дайджесты — это разновидность документов, которая создаётся с помощью мастера и содержит краткий обзор какой-то ленты сообщений.
- Если приглядеться, станет понятно, что Рубрики (ключевые слова) — по сути тоже документы. Между названием рубрики и перечнем связанных с ней записей вы можете ввести краткое описание рубрики — отредактировав тело документа.