Plataformas de documentação de TI [fechado]

21

Somos uma operação crescente de TI que continua a oferecer ofertas e suporte adicionais a uma variedade de clientes. À medida que continuamos a sustentar esse crescimento, descobrimos que precisamos ter acesso fácil a informações e documentação sobre nossos vários sistemas e software em nossas equipes de TI. Temos três áreas funcionais principais em nosso grupo de TI que incluem:

  1. equipe de suporte técnico (nível 1),
  2. desenvolvedores e programadores e
  3. administradores de sistema / administradores de rede / analistas de segurança (nível 2).

Atualmente, temos informações para o Nível 1 armazenadas em um wiki baseado no MediaWiki e que provou ser muito bem-sucedido para a equipe de suporte técnico. Os desenvolvedores e programadores foram para o Redmine para rastrear seus projetos, problemas e documentação do projeto. Os administradores (Nível 2) não têm um repositório centralizado de conhecimento e confiam nos arquivos do MS Word espalhados em unidades de rede, máquinas pessoais, conhecimento que está disponível apenas para um indivíduo em particular, uma vez que não o documentou em nenhum lugar, etc.

O desafio que temos agora é que precisamos ter um local centralizado para registrar informações e documentação do Nível 2. No entanto, já temos dois outros sistemas em funcionamento. Idealmente, gostaríamos de ter uma plataforma de documentação que funcionasse no mínimo para os níveis 1 e 2, com a possibilidade de adicionar também os programadores. Essa plataforma precisaria ter a capacidade de manter determinado conteúdo separado. Por exemplo, há informações confidenciais (como construímos nossos servidores, possíveis nomes de usuário etc.) no nível do Nível 2 que o Nível 1 não precisa saber. Além disso, o Nível 2 deve ter acesso às informações no Nível 1 e acima. Pensamos em estender nossa instalação do MediaWiki para isso, mas a ACL ' s e a proteção das informações dos usuários do wiki pareciam trabalhos de hackers que não eram bem suportados e contrários ao espírito de acesso aberto e fácil a informações que estão no centro de um wiki. Estou procurando idéias e sugestões que atendam aos critérios listados acima, além dos seguintes objetivos adicionais:

  1. De preferência, software livre ou de código aberto (e uma ferramenta da Web), pois não temos realmente um orçamento para isso
  2. Uma plataforma que não contém um elemento de emissão de bilhetes, pois temos um sistema separado que lida com isso nos níveis 1 e 2
  3. Uma plataforma que não precisa dos recursos de gerenciamento de projetos para os Níveis 1 e 2
  4. Um produto flexível e fácil de adicionar documentação, que inclui tabelas, marcação fácil, destaque de sintaxe, imagens, diagramas de rede, etc.
  5. Recursos de pesquisa de texto completo, possivelmente com recursos de linguagem natural
  6. A capacidade de suportar uploads e downloads de arquivos
  7. Possivelmente possui feeds RSS ou Atom e alertas de atualizações por email
  8. Permitir que a autenticação LDAP possa ser integrada a um ambiente SSO existente
  9. Uma plataforma que não requer muito tempo de desenvolvimento ou muita criação de código personalizado
  10. Controle de acesso com base no usuário, função, associação ao grupo, por documentos / páginas individuais ou um conjunto de documentos / páginas, de modo que, se você não tiver acesso a essa seção do site / documento / página / associação, não verá o link ou conteúdo
  11. De preferência, tenha um editor interno para ajudar a facilitar a entrada de dados e a publicação de documentação
  12. O controle de versão e a auditoria incorporados seriam preferíveis
  13. A capacidade de exportar páginas ou uma coleção ou páginas para um arquivo PDF
  14. A capacidade de escalar bem, devemos continuar a crescer e expandir
  15. Talvez ofereça suporte à capacidade de rastrear o uso ou executar análises
  16. Usado apenas para uso interno e não será voltado para o cliente ou acessível
  17. A capacidade de oferecer suporte ao gerenciamento de trechos de informações, como instruções, procedimentos, soluções, projetos, compilações de servidores, documentação de rede etc.
  18. Não precisa de recursos de integração social
  19. Possivelmente suporte à capacidade de ter ou adicionar a ele inventário de sistemas (servidores e máquinas clientes)
  20. Permitir a importação das informações do MediaWiki se precisarmos mudar de plataforma

Além disso, existem muitos locais on-line que falam sobre sistemas especializados que permitem a criação de fluxos de trabalho para solução de problemas semelhantes a um fluxograma ou a um assistente passo a passo. Isso é algo que devemos considerar como uma opção em nossa plataforma de documentação? Quão útil isso seria e é algo que ajudaria o Nível 1 a executar melhor seu trabalho? Há também algumas informações online que falam sobre as diferenças entre gerenciamento de conteúdo e gerenciamento de conhecimento . Isso é algo que devemos considerar como parte dos requisitos de uma plataforma de documentação?

Sei que esta postagem é mais longa e agradeço a ajuda e o feedback que você pode fornecer. Estou tentando garantir que eu faça as perguntas certas e cubra as bases para ajudar a tomar uma decisão mais informada, além de implementar uma solução que seja viável a longo prazo, para que não continuemos a refazer os sistemas que acabamos de implementar. Agradecemos novamente antecipadamente e espero ler o que você compartilha.

John
fonte

Respostas:

13

Sei que isso não é gratuito, mas acho que os produtos Altassian podem atender às suas necessidades. Especificamente, o Confluence Wiki pode ajudar com sua documentação e o módulo JIRA pode fazer o rastreamento de problemas / bugs.

SLY
fonte
+1 usamos confluência para wiki e JIRA para rastreamento de problemas / PM
iainlbc 02/02
Temos o Confluence no trabalho e gosto muito dele (também o uso em casa). É realmente um ótimo produto, com muitos recursos (muitos dos quais atendem às suas necessidades) e um rico catálogo de plugins (muitos dos quais são gratuitos). Você definitivamente deve experimentá-lo (e marcar com +1 também para JIRA e GreenHopper, outros dois ótimos produtos da Atlassian).
precisa
Devo dizer que realmente não gosto do Confluence depois da minha experiência com ele. Faltam muitos recursos, e o pior é que você não pode visualizar e editar a fonte.
einpoklum - reinstala Monica 31/03
14

Para não simplificar demais, o Sharepoint vem à mente.

joeqwerty
fonte
Ele mencionou que eles não têm um orçamento para isso, portanto o Sharepoint provavelmente não é o ideal. Se eles são parceiros da Microsoft, podem ter algumas licenças disponíveis, mas possivelmente não o suficiente para cobrir toda a empresa.
David Yu
8
O Windows Sharepoint Services é gratuito. Eu deveria ter especificado isso na minha resposta.
precisa saber é o seguinte
Existem outras idéias além do Sharepoint? No passado, não estávamos muito interessados ​​nessa plataforma devido à inacessibilidade de seus documentos, uma vez que eles estão bloqueados na plataforma Sharepoint.
João
10
Como os documentos estão inacessíveis? Mesmo se todas as pessoas da sua organização se recusarem a usar o IE, você poderá mapear uma biblioteca de documentos para uma letra de unidade usando o webdav. Existe até um modelo WSS gratuito para o Help Desk e rastreamento de erros, que inclui muitas funcionalidades, como gráficos, wikis e artigos da base de conhecimento que podem ser vinculadas a vários tickets de problemas (ou os tickets podem ser vinculados aos artigos da KB). E você também pode usar o SharePoint Designer (também gratuito) para adicionar fluxos de trabalho além disso.
Robert Kaucher 02/02
@Robert: +1. Se eu pudesse "comentar" seu comentário mais de uma vez, eu o faria.
Joeqwerty
4

Pessoalmente, eu iria para um wiki (eu gosto de Trac ) ou Plone .

Em um empregador anterior, usamos o Plone para um aplicativo de KB interno, no qual o Suporte tinha certas permissões de r / w, o gerenciamento possuía outras e o desenvolvimento possuía outra.

Warren
fonte
3

Jira e Confluence são muito interessantes para isso, como SLY mencionou. No final gratuito, você tem o Trac e seus plugins relevantes que também vêm à sua mente.

Então, novamente, você está procurando uma pia de cozinha grátis e nenhuma das recomendadas até agora fornecerá toda a funcionalidade desejada.

Se você tiver alguns ciclos extras, poderá liberá-lo, o Trac é extensível através de plug-ins, para que você possa adicionar algumas das funcionalidades necessárias.

jonathanserafini
fonte
2

Eu vou morder.

Eu tive boa sorte com o MoinMoin . É um mecanismo wiki que suporta quase tudo o que você procura e é usado por algumas grandes organizações, incluindo Ubuntu, Apache Foundation etc. Mas inclui ACLs, integração LDAP, exportação de páginas para PDF e editor WYSIWYG. Além do editor WYSIWYG, ele também suporta uma linguagem de marcação wiki, se você deseja editar as páginas que o utilizam. A interface WYSIWYG também oferece suporte à cópia e colagem do Word, para ajudar a migrar a documentação existente do Word.

No passado, eu o usei como uma plataforma de inventário e histórico do sistema, usando algumas de suas macro e modelos integrados para permitir que você adicione novos equipamentos e eventos ao wiki usando um formulário.

O único problema que vejo com seus requisitos é a importação de dados do mediawiki. Existem alguns scripts, mas são um pouco irregulares e são limitados.

3dinfluence
fonte
2

Certamente, parece que um Wiki é o caminho certo a seguir. Não há produtos finais por aí - mas, como você diz, algumas vezes a funcionalidade principal é um tanto ad-hoc em sua implementação (por exemplo, a pesquisa não sabe sobre o subsistema de permissões que leva ao vazamento de informações restritas).

Eu uso o dokuwiki - que (como a maioria dos wikis) marca a maioria das caixas que você perguntou, no entanto, é muito bem intergado e também me permite incorporar o PHP nas páginas com muita facilidade (embora para um sistema com um número muito grande de usuários, considere adicionar uma tag personalizada para fazer referência a scripts fora do wiki em vez de fornecer acesso direto ao intérprete). Certamente pode ser dimensionado para suportar um grande número de usuários, mas, com base em arquivos simples, há um limite para a quantidade de dados que ele pode armazenar.

http://www.wikimatrix.org/wiki/comparison fornece uma maneira rápida de verificar os recursos.

symcbean
fonte
Eu uso wikimatrix.org/wiki/comparison para obter o melhor wiki. Finalmente eu tenho decidir ter uma chance com MindTouch Deki Wiki sourceforge.net/projects/dekiwiki
Matias Dominoni
1

O Nuxeo possui uma solução de gerenciamento de documentos de código aberto licenciada sob a LGPL.

A sinopse do marketing:

O Nuxeo DM é uma solução de gerenciamento de documentos criada com a tecnologia Nuxeo Enterprise Platform flexível e robusta. Ao gerenciar e rastrear o fluxo de conteúdo durante o ciclo comercial, o Nuxeo DM aborda as armadilhas comuns da duplicação de documentos, falta de rastreamento de versão, pesquisa e recuperação demoradas e problemas de segurança e acesso. Por quê? Simplesmente porque o gerenciamento de documentos vai além do armazenamento de documentos em um servidor de arquivos; trata-se de gerenciar a maneira como sua empresa interage com o conteúdo. Continue lendo para descobrir por que nossos clientes nos dizem que o Nuxeo DM é a melhor solução para suas iniciativas de gerenciamento de conteúdo e documento.

O Alfresco também possui uma solução de gerenciamento de documentos , mas faz parte da oferta da empresa, não a edição da comunidade de código aberto.

Kenny Rasschaert
fonte
0

Muitos dos recursos desejados que você está procurando podem ser encontrados no Kablink Vibe.

http://sourceforge.net/projects/kablink/

http://www.kablink.org/

Sn3akyP3t3
fonte
Bem-vindo à falha do servidor! Geralmente, gostamos de respostas no site para poder se manter por conta própria - os links são ótimos, mas se esse link quebrar, a resposta deve ter informações suficientes para continuar sendo útil. Considere editar sua resposta para incluir mais detalhes. Veja o FAQ para mais informações.
SLM