Назад | Перейти на главную страницу

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Я укушу.

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

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

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

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

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

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

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

Рекламный ролик:

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

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

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

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

http://www.kablink.org/