Using Discourse as a internal Knowledge Base / Intranet

Thanks, @jaevanryssel. This definitely helps a bit. We use Slack too and so there has been some discussion on when Slack is appropriate vs Discourse.

funny that this thread is being reawakened now. I am working on this right now - we use discourse as a community forum and for internal staff discussions. I’d like to reconfigure things so it’s optimal for both, but it’s been a bit of a challenge. For example internal discussions swamp the frontpage for staff so sometimes it’s hard for them to see and deal with community discussions. For today I am trying out the “hide category from frontpage” setting and adding a link to that category on the top menu, visible only to staff.

I also am looking to create a wiki category with sub-categories, to contain operating procedures and how-to docs for staff. This is working well, especially with the “boxes with topics” category view - like the howto category here - see screenshot. I like! I think it will be a big improvement over the google docs we were using previously for this purpose. Especially when considering that it can respect permissions and show people only the sub-category of procedures that they need to see according to their role.

Up next, I think, is to figure out a way to present the wiki topics in a structured interface externally, so it can be used without the distraction of discourse discussion features, safely also when discourse is down, and also perhaps even offline saved as structured PDFs.

The learndiscourse experiment might be a help for this - and if anyone has done it recently with success and has a recipe for it I’d love to see it! Sadly, learndiscourse.org is not working right now.

https://github.com/erlend-sh/learndiscourse/blob/gh-pages/about.md

7 лайков

This is great! I’m also thinking about using discourse as a KB. Only issue I’m seeing so far is localization, seems like that would be a bit more painful than the solution we have now.

There isn’t really a way to have a single topic localized is there?

1 лайк

The same topic translated into multiple languages? Not really, no. Once you get to that kind of upscale requirement I think it’s time to transition to a specialized docs platform. Using something like https://www.gatsbyjs.org you could continue using Discourse as the data source for your English content, whilst translating the rest in Transifex.

3 лайка

Wiki против bulletin-системы: Я не до конца убеждён в идее внедрения bulletin-системы для управления знаниями. В общем случае, если все знакомы с общим местом в иерархии, легко сослаться на что-либо. При поиске вы можете не вспомнить точное слово или ключевое слово, но будете знать расположение. Я рассматриваю аналогию наличия индекса против поиска среди большого объёма информации, чтобы извлечь именно ту информацию, которая вам нужна.

Confluence Wiki против других Wiki: Я открыт к использованию альтернативной wiki, удобной для работы с кодом, возможно, такой, которая может интегрировать изменения, происходящие с кодом, чтобы она обновлялась, например: https://www.mkdocs.org/.

Я наткнулся на этот пост, так как тоже ищу хорошее решение для базы знаний/wiki для моей компании.

Я заметил, что в Discourse есть такая настройка, и она мне нравится.

Можно ли это легко настроить из коробки? Мне нравится чистый внешний вид и организация через категории и теги.

Редактирование: Также интересно, есть ли в этом наборе ещё несколько функций:

  1. Контроль версий с возможностью отката
  2. Процесс утверждения/запроса на слияние (pull request) для определённых элементов
2 лайка

Привет, Джордан! Да, это можно включить с помощью официального плагина: Discourse Docs.

Темы — это обычные темы Discourse, которые обеспечивают контроль версий. Насчёт конвейера типа pull request не уверен — не могли бы вы уточнить?

3 лайка

@tobiaseigen Отлично! Спасибо вам за это. Я изучу это подробнее.

Что касается сценария с утверждением или запросом на слияние (pull request), я постарался изложить свои мысли более четко ниже:

Я привожу пример с запросом на слияние, потому что считаю, что этот подход хорошо работает для разработки программного обеспечения, а также мог бы (и, как я полагаю, используется в некоторых программах типа вики, например, Gollum) служить способом контроля обновлений определенных статей базы знаний. Для уточнения: на самом деле это может быть любой тип рабочего процесса утверждения, я просто использую запрос на слияние как знакомый пример.

То есть: кто-то является владельцем этой статьи, и любые обновления этой статьи должны быть представлены в виде запроса на слияние (или аналогичного) для проверки и утверждения.

Всё ли понятно?

Это встроено в историю редактирования Discourse-core.

Вы можете настроить категории так, чтобы новые темы требовали одобрения модератора. В ядре этой функции пока нет, но есть открытая заявка на её добавление.

Однако это не будет касаться создателя темы. Утверждать сообщения смогут только сотрудники.

2 лайка

Здравствуйте,

Я работаю в крупной международной страховой компании и занимаюсь проектированием внутренней базы знаний, которая будет аккумулировать накопленные знания по различным темам. Меня интересует, может ли платформа Discourse синхронизироваться с продуктами Microsoft Office. Например, в нашей компании мы используем Microsoft Office (Outlook для электронной почты, SharePoint для хранения файлов и т. д.). Можно ли каким-либо образом интегрировать форум Discourse с продуктами Microsoft Office, чтобы сотрудники организации могли к нему обращаться?

Если на предыдущий вопрос ответ положительный, существуют ли разработчики с опытом создания платформ Discourse для организаций (через интранет-системы), которых можно нанять?

Заранее спасибо.

Вы имеете в виду настройку Discourse для аутсорсинга входа через Microsoft 365?

Мы предлагаем услуги интеграции такого рода в рамках нашего корпоративного плана хостинга. Узнайте больше на Discourse Enterprise | Discourse - Civilized Discussion и свяжитесь с нами, предоставив детали.

3 лайка

Спасибо за этот ответ. Я отправил вашей команде письмо по электронной почте с моим запросом :slight_smile:

Это хорошее обсуждение. Возможно, кто-то здесь сможет мне помочь. Я пытаюсь использовать Discourse внутри нашей компании как для пользовательского контента (форумы), так и в качестве внутренней базы знаний.

Мне нравится скриншот, который @tobiaseigen поделил еще в январе 2018 года, это именно то, что я ищу. Но есть ли способ обеспечить редакционный контроль? Например, я хочу задавать порядок статей, чтобы выстроить определенную повествовательную линию. Также не уверен, поддерживает ли этот вид отображение более чем трёх лучших статей. Кто-нибудь может помочь?

Я также сталкиваюсь с вопросами пользователей о том, как делиться документами в Discourse.
Я не нашел никаких официальных плагинов, позволяющих это сделать.
Однако этот плагин, похоже, реализует нечто интересное: Discourse OneDrive Picker
Было бы отлично интегрировать в Discourse решения для обмена файлами :heart_eyes: