Платформы ИТ-документации [закрыто]

21

Мы являемся растущей ИТ-службой, которая продолжает предоставлять дополнительные предложения и поддержку различным клиентам. Продолжая поддерживать этот рост, мы обнаружили, что нам необходимо иметь легкий доступ к информации и документации о наших различных системах и программном обеспечении в наших ИТ-командах. У нас есть три основные функциональные области в нашей ИТ-группе, которые включают в себя:

  1. персонал службы поддержки (уровень 1),
  2. разработчики и программисты, и
  3. системные администраторы / сетевые администраторы / надежные аналитики (уровень 2).

В настоящее время у нас есть информация для уровня 1, хранящаяся в вики, которая основана на MediaWiki и которая оказалась очень успешной для команды службы поддержки. Разработчики и программисты переехали в Redmine для отслеживания своих проектов, проблем и проектной документации. Администраторы (уровень 2) не имеют централизованного хранилища знаний и полагаются на файлы MS Word, которые разбросаны по сетевым дискам, персональным компьютерам, знаниям, которые доступны только конкретному лицу, поскольку они нигде не документировали его и т. Д.

Проблема, с которой мы сталкиваемся сейчас, заключается в том, что нам необходимо иметь централизованное местоположение для записи информации и документации для уровня 2. Однако у нас уже есть две другие системы. В идеале мы хотели бы иметь платформу документации, которая как минимум работала бы для уровня 1 и уровня 2 с возможностью добавления в нее программистов. Эта платформа должна иметь возможность поддерживать определенный контент отдельно. Например, на уровне уровня 2 имеется конфиденциальная информация (как мы создаем наши серверы, возможные имена пользователей и т. Д.), Которую уровень 1 не должен знать. Кроме того, уровень 2 должен иметь доступ к информации уровня 1 и выше. Мы думали о расширении нашей установки MediaWiki для этого, но ACL ' Защита информации от пользователей вики казалась хакерской работой, которая плохо поддерживалась и противоречила духу открытого и легкого доступа к информации, которая лежит в основе вики. Я ищу идеи и предложения, которые соответствуют вышеуказанному критерию, а также следующие дополнительные цели:

  1. Желательно бесплатное или открытое программное обеспечение (и веб-инструмент), так как у нас на самом деле нет бюджета на это
  2. Платформа, которая не содержит элемент тикета, так как у нас есть отдельная система, которая обрабатывает это для уровня 1 и уровня 2
  3. Платформа, которая не нуждается в возможностях управления проектами для уровня 1 и уровня 2
  4. Гибкий продукт, в который легко добавить документацию, включая таблицы, простую разметку, подсветку синтаксиса, изображения, сетевые диаграммы и т. Д.
  5. Возможности полнотекстового поиска возможно с возможностями естественного языка
  6. Возможность поддержки загрузки и скачивания файлов
  7. Потенциально есть RSS или Atom каналы и уведомления по электронной почте об обновлениях
  8. Разрешить интеграцию аутентификации LDAP в существующую среду единого входа
  9. Платформа, которая не требует много времени разработки или большого количества пользовательского кода
  10. Контроль доступа на основе пользователя, роли, членства в группе, для отдельных документов / страниц или набора документов / страниц, так что если у вас нет доступа к этому разделу сайта / документа / страницы / членства, вы не видите ссылку или содержание
  11. Желательно иметь встроенный редактор, чтобы облегчить ввод данных и размещение документации
  12. Встроенный контроль версий и аудит предпочтительнее
  13. Возможность экспорта страниц или коллекции или страниц в файл PDF
  14. Способность хорошо масштабироваться, если мы будем продолжать расти и расширяться
  15. Может быть, поддерживать возможность отслеживать использование или выполнять аналитику
  16. Используется только для внутреннего использования и не будет ориентирован на клиента или доступен
  17. Возможность поддержки управления фрагментами информации, такими как инструкции, процедуры, решения, проекты, сборки серверов, сетевая документация и т. Д.
  18. Не нужны возможности социальной интеграции
  19. Возможно поддержка возможности иметь или добавлять к нему инвентарь систем (серверов и клиентских машин)
  20. Разрешить импорт информации MediaWiki, если нам нужно переключить платформы

Кроме того, в Интернете есть много мест, где рассказывают об экспертных системах, которые позволяют создавать рабочие процессы устранения неполадок, аналогичные потоковой диаграмме или пошаговому мастеру. Это то, что мы должны рассмотреть в качестве опции на нашей платформе документации? Насколько это будет полезно, и поможет ли это Уровню 1 лучше выполнять свою работу? В Интернете также есть некоторая информация о различиях между управлением контентом и управлением знаниями . Это то, что мы должны рассматривать как часть требований платформы документации?

Я знаю, что эта публикация длиннее, и я ценю помощь и отзывы, которые вы можете предоставить. Я стараюсь удостовериться, что задаю правильные вопросы и покрываю основы, чтобы помочь принять более обоснованное решение, а также внедрить решение, которое будет жизнеспособным в долгосрочной перспективе, чтобы мы не продолжали пересматривать системы, которые мы только что реализовали. Еще раз спасибо заранее, и я с нетерпением жду, что вы поделитесь.

Джон
источник

Ответы:

13

Я знаю, что это не бесплатно, но я думаю, что алтасские продукты могут удовлетворить ваши потребности. В частности, Confluence Wiki может помочь с вашей документацией, а модуль JIRA может отслеживать проблемы / ошибки.

SLY
источник
+1 мы используем слияние для вики и JIRA для отслеживания проблем / PM
iainlbc
У нас есть Confluence на работе, и я очень люблю это (я также использую это дома). Это действительно отличный продукт, с множеством функций (большинство из которых удовлетворяют вашим требованиям) и богатым каталогом плагинов (многие из которых бесплатны). Вы должны обязательно попробовать (и +1 также для JIRA и GreenHopper, двух других замечательных продуктов от Atlassian).
dSebastien
Я должен сказать, что я действительно не люблю Слияние после моего опыта с ним. В нем отсутствуют многие функции, и хуже всего то, что вы не можете просматривать и редактировать исходный код.
einpoklum - восстановить Monica
14

Не слишком упрощать, но Sharepoint приходит на ум.

joeqwerty
источник
Он упомянул, что у них нет на это бюджета, поэтому Sharepoint, вероятно, не оптимален. Если они являются партнерами Microsoft, им могут быть доступны некоторые лицензии, но, возможно, их недостаточно для охвата всего предприятия.
Дэвид Ю
8
Службы Windows Sharepoint предоставляются бесплатно. Я должен был указать это в своем ответе.
Joeqwerty
Есть ли другие идеи, кроме Sharepoint? В прошлом мы не слишком интересовались этой платформой из-за недоступности ваших документов после их блокировки на платформе Sharepoint.
Джон
10
Как документы недоступны? Даже если каждый сотрудник вашей организации отказывается использовать IE, вы можете сопоставить библиотеку документов с буквой диска с помощью webdav. Существует даже бесплатный шаблон WSS для службы поддержки и отслеживания ошибок, который включает множество функций, таких как диаграммы, вики и статьи KB, которые можно связать с несколькими заявками на устранение неисправностей (или заявки можно связать со статьями KB). И вы также можете использовать SharePoint Designer (также бесплатно), чтобы добавить рабочие процессы поверх этого.
Роберт Каучер
@ Роберт: +1. Если бы я мог «поднять» ваш комментарий более одного раза, я бы так и сделал.
Joeqwerty
4

Лично я бы пошел на вики (мне нравится Trac ) или Plone .

У предыдущего работодателя мы использовали Plone для внутреннего приложения KB, в котором у службы поддержки были определенные права доступа, у управления были другие, а у разработки - еще одна.

кроличий садок
источник
3

Jira и Confluence очень интересны для этого, как отметил SLY. На свободном конце у вас будет Trac и соответствующие плагины, которые также приходят на ум.

Опять же, вы ищете бесплатную кухонную раковину, и ни один из рекомендованных до сих пор не обеспечит всю желаемую функциональность.

Если у вас есть несколько дополнительных циклов, которые вы можете освободить для этого, Trac расширяется с помощью плагинов, так что вы можете добавить некоторые необходимые вам функции.

jonathanserafini
источник
3

Я также считаю, что вики лучше всего подходит для ваших требований. В Википедии очень хорошее сравнение программного обеспечения вики с функциями, целевой аудиторией, лицензированием / стоимостью и т. Д. , Так что вы можете посмотреть в дополнение к рекомендациям в других ответах.

Аксель Кнауф
источник
2

Я укушу

Мне повезло с MoinMoin . Это вики-движок, который поддерживает большую часть того, что вы ищете, и используется некоторыми крупными организациями, включая Ubuntu, Apache Foundation и т. Д. Но он включает ACL, интеграцию LDAP, экспорт страниц в PDF и редактор WYSIWYG. В дополнение к редактору WYSIWYG он также поддерживает язык разметки вики, если вы хотите редактировать страницы, используя его. Интерфейс WYSIWYG также поддерживает копирование и вставку из Word, что может помочь перенести существующую документацию Word.

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

Единственная проблема, с которой я столкнулся при ваших требованиях, это импорт данных из MediaWiki. Есть пара сценариев, но они немного грубые и ограничены.

3dinfluence
источник
2

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

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

http://www.wikimatrix.org/wiki/comparison предоставляет быстрый способ проверки функций.

symcbean
источник
Я использую wikimatrix.org/wiki/comparison , чтобы получить лучшую вики. Наконец, я решил рискнуть с Mindtouch Deki Wiki sourceforge.net/projects/dekiwiki
Матиас Доминони
1

Nuxeo имеет решение для управления документами с открытым исходным кодом, лицензированное в соответствии с LGPL.

Маркетинговая реклама:

Nuxeo DM - это решение для управления документами, созданное с использованием гибкой и надежной технологии Nuxeo Enterprise Platform. Управляя и отслеживая поток контента в течение бизнес-цикла, Nuxeo DM решает распространенные проблемы дублирования документов, отсутствия отслеживания версий, трудоемкого поиска и извлечения, а также проблем безопасности и доступа. Зачем? Просто потому, что управление документами выходит за рамки хранения документов на файловом сервере; речь идет об управлении взаимодействием вашего бизнеса с контентом. Продолжайте читать, чтобы узнать, почему наши клиенты говорят нам, что Nuxeo DM - лучшее решение для их инициатив по управлению контентом и документами.

У Alfresco также есть решение для управления документами , но оно является частью их корпоративного предложения, а не выпуска сообщества с открытым исходным кодом.

Кенни Рассчарт
источник
0

Многие из желаемых функций, которые вы ищете, можно найти в Kablink Vibe.

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

http://www.kablink.org/

Sn3akyP3t3
источник
Добро пожаловать в сбой сервера! Как правило, нам нравятся ответы на сайте, чтобы они могли стоять сами по себе - Ссылки - это здорово, но если эта ссылка когда-либо разорвется, в ответе должно быть достаточно информации, чтобы она оставалась полезной. Пожалуйста, рассмотрите возможность редактирования своего ответа, чтобы включить более подробную информацию. Смотрите FAQ для получения дополнительной информации.
SLM