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 curtidas

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 curtida

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 curtidas

Wiki vs. Boletim: Não estou totalmente convencido da ideia de ter um sistema de boletim para Gestão do Conhecimento. De modo geral, se todos estiverem familiarizados com um local comum em uma hierarquia, é fácil referenciar algo. Na busca, você pode não se lembrar da palavra exata ou da palavra-chave necessária, mas saberá o local. Vejo isso como uma analogia entre ter um índice versus vasculhar uma grande quantidade de informações para extrair exatamente a informação de que você precisa.

Confluence Wiki vs. Outras Wikis: Estou aberto a usar uma wiki alternativa amigável para código, talvez algo que possa integrar as alterações que ocorrem com o código, de modo que seja atualizado, por exemplo, https://www.mkdocs.org/.

Eu acabei de encontrar este post, pois também estou procurando uma boa solução de base de conhecimento/wiki para minha empresa.

Percebi que o Discourse tem essa configuração e gostei dela.

Isso é algo facilmente configurável “fora da caixa”? Gosto da aparência limpa e da organização por meio de categorias e tags.

Edição: Também estou me perguntando se há alguns outros conjuntos de recursos disponíveis aqui:

  1. Controle de versão com reversão
  2. Pipeline do tipo aprovação/solicitação de alteração para certos itens
2 curtidas

Olá, Jordan! Sim, isso pode ser ativado usando o plugin oficial: Discourse Docs.

Os tópicos são tópicos normais do Discourse, que oferecem controle de versão. Não tenho certeza sobre o pipeline do tipo pull request — você poderia dar mais detalhes sobre isso?

3 curtidas

@tobiaseigen Perfeito! Obrigado por isso. Vou investigar mais a fundo.

Em relação ao cenário de tipo de aprovação ou pull request, tentei organizar algumas ideias mais claras abaixo:

Falo em pull request como exemplo, porque acho que funciona muito bem para desenvolvimento de software e também poderia ser (e é, em alguns softwares do tipo wiki, como o Gollum, imagino) uma forma de controlar atualizações de certos artigos da Base de Conhecimento. Para esclarecer, realmente poderia ser qualquer tipo de fluxo de aprovação; estou apenas usando o pull request como um exemplo familiar.

Ou seja: alguém é o responsável pelo artigo e qualquer atualização nesse artigo precisa ser submetida como um pull request (ou algo similar) para revisão e aprovação.

Faz sentido?

Isso já está integrado ao histórico de edições do núcleo do Discourse.

Você pode configurar tópicos para exigir aprovação de moderador para novos tópicos em uma categoria. Não temos esse recurso no núcleo, mas há uma solicitação de recurso aberta para isso.

No entanto, isso não se aplicaria ao criador do tópico. Apenas membros da equipe poderiam aprovar as postagens.

2 curtidas

Olá,

Trabalho em uma grande seguradora global e fui encarregado de projetar uma base de conhecimento interna que capture o conhecimento acumulado sobre uma variedade de tópicos. Gostaria de saber se a plataforma Discourse consegue sincronizar com produtos do Microsoft Office. Por exemplo, na minha empresa, utilizamos o Microsoft Office (Outlook para e-mail, SharePoint para armazenamento de arquivos, etc.). Seria possível integrar um fórum Discourse ao Microsoft Office de alguma forma, permitindo que os usuários da organização acessem?

Se a resposta for sim, existem desenvolvedores com experiência em criar plataformas Discourse para organizações (por meio de um sistema intranet) que estejam disponíveis para contratação?

Agradeço antecipadamente.

Você quer dizer configurar o Discourse para delegar o login ao Microsoft 365?

Oferecemos serviços de integração desse tipo em nosso plano de hospedagem Enterprise. Confira em Discourse Enterprise | Discourse - Civilized Discussion e entre em contato conosco com os detalhes.

3 curtidas

Obrigado pela resposta. Enviei um e-mail à sua equipe de forma privada sobre meu pedido :slight_smile:

Essa é uma boa discussão. Talvez alguém aqui possa me ajudar. Estou tentando usar o Discourse internamente na minha empresa tanto para conteúdo gerado por usuários (fóruns) quanto para uma base de conhecimento interna.

Gostei muito da tela que @tobiaseigen compartilhou em janeiro de 2018; é exatamente o que estou procurando. Mas existe alguma maneira de eu ter controle editorial? Por exemplo, quero especificar a ordem dos artigos para criar uma certa narrativa. Também não tenho certeza se essa visualização suporta mais do que apenas os 3 principais artigos. Alguém pode ajudar?

Também estou enfrentando usuários perguntando como compartilhar documentos no Discourse.
Não encontrei nenhum plugin oficial que permita isso.
Mas este parece impulsionar algo interessante: Discourse OneDrive Picker
Seria ótimo integrar soluções de compartilhamento de arquivos ao Discourse :heart_eyes: