База знаний ABAP программиста

1405186568_118806С увеличением объема информации необходимой для выполнения своих профессиональных обязанностей, перед каждым IT специалистом, а в особенности программистами, встаёт задача её быстрого поиска, для чего информация должна быть хорошо структурирована, актуальна, а поиск по ней должен выдавать релевантные результаты.

В данной статье будет рассмотрен один из способов построения простейшей базы знаний, с помощью продукта Help & Manual (H&M).

Ранее являясь Delphi разработчиком, часто приходилось использовать базу знаний DRKB (Delphi Russian Knowledge Base), база содержит более 4000 хорошо классифицированных и тщательно оформленных статей. Основным на то время вариантом этой базы являлся CHM файл (Microsoft Compressed HTML Help — формат справки от MS).

Внешне структура справки выглядит следующим образом:

drkb

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

Разработка на языке ABAP как и Delphi подразумевает использование большого числа технологий: концепции работы с базами данных, объектами словаря, всевозможными способами межсистемной интеграции, средствами построения отчётности, знаний в области API для различных модулей SAP (например, функции работы с инфотипами HR), технологий расширения системы и множества других.

С помощью SDN и портала справочной системы SAP (help.sap.com), а так же источников в интернете можно решить большинство вопросов связанных с поиском нужной информации, однако и они полностью не решают некоторые из них, да и структурированность оставляет желать лучшего.  В качестве дополнительного источника информации и с целю сохранения и накопления опыта, мной была создана похожая на DRKB база знаний, только относительно языка ABAP и за вычетом некоторых её недостатков.

Недостатки CHM как формата для базы знаний:

  • Нет возможности встраивать внешние форматы электронных документов, таких как PDF, DJVU и др.
  • Нет возможности встраивать видео
  • Отсутствие нормальной кроссплатформенности
  • Отсутствие возможности работы через Web

В качестве ПО для создания базы был выбран H&M, альтернативным решением может быть Doc-To-Help. Оба продукта позволяют создавать справочную систему в Web формате, с возможностью изменения шаблонов «под себя».

Структура базы данных в настоящий момент выглядит следующим образом:

help_structure

Как видно из рисунка, сейчас это около 3000 статей, заметок, внешних ссылок на литературу и прочие источники (размер в настоящий момент около 45 ГБ). Встраивание внешних файлов выполняется через iframe, следующим образом:

external_pdf

Просмотр файла файла в браузере:

help_in_web

Видео интегрируется через HTML тэг Video:

H&M позволяет вставлять в содержимое статей форматированный текст из Word:

code_highlight

Кроме того в справочной системе есть встроенный поиск наподобие поиска в CHM файлах:

web_search

Создание и использование подобной базы знаний позволяет в значительной степени ускорить поиск необходимой в повседневной деятельности информации. H&M позволяет так же вести обновление/синхронизацию файла справки из нескольких источников, что делает её неким подобием Wiki.

Хотелось бы поинтересоваться у читателей данной статьи, есть ли подобные решения у Вас, может быть Wiki или нечто подобное?

Шаблон используемый при создании данной базы знаний можно взять тут.

  • Александр

    У нас все хранится по папкам (sharepoint), поиск через портал.

  • KT

    Ведётся библиотека повторного использования с описанием Z-ФМ, классов, программ в виде Word документа.

  • Anton Bulavlev

    Все храню в https://www.evernote.com/ в отдельном блокноте

    P.S.
    Вы не планируете выложить базу знаний в общий доступ?

    • Astrafox

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

      • Алексей

        Добрый день. Если не сложно, можете поделиться самой базой? vsepol@mail.ru

  • Андрей

    Help & Manual — программа отличная, но для домашнего использования от 400 баксов за лицензию, это очень много.

    Есть программа mars notebook — да, возможностей меньше, но очень демократичная цена за лицензию

  • Nikolay Durnev

    Справочные материалы и ссылки храню в вики, на веб-сервере. Хорошее решение для базы знаний.

  • Xzander

    Здравствуйте!
    Вышлите и мне ABAP Cookbook от James Wood , пожалста. raaxz@mail.ru
    Буду очень благодарен!

    • Александр

      Добрый день,
      Если не сложно вышлите и мне ABAP Cookbook от James Wood,

      popov_alex05@mail.ru

      • Xzander

        И вам добрый. К сожалению, мне ничего не приходило на почту.

  • bingur

    Здравствуйте ! можно и мне ABAP Cookbook от James Wood
    bingur@rcpt.at благодарю!!

  • Aksan

    Добрый день! можно и мне скинуть ABAP Cookbook от James Wood. Заранее благодарю! aks.an@mail.ru

  • Ильмир Нуриев

    Можно мне тоже на почту? insaf121@ya.ru

  • Александр

    Добрый день! Можно и мне ABAP Cookbook от James Wood — alexander2305@yandex.ru заранее благодарен!!!

  • Александр

    Я использую прогу SANRAV. При необходимости выгружаю базу из sanrav в CHM. Также есть прога
    MAPLE PROFESSIONAL

  • Павел

    Использую MS OneNote.

  • Евгений

    Добрый день! Я начинающий ABAPер и мне бы очень помогла база знаний которую Вы создали! Если Вам не трудно и не жалко, можно попросить Вас сбросить мне её? Вы мне очень поможете. Надеюсь что в этом мире еще не развелись добрые люди!
    Почта — roni_2006@ukr.net

  • Игорь

    Уважаемый Astrafox, поделитесь, пожалуйста, вашей базой, если не сложно. Email в профиле.

  • Crystal_Ra

    My Notes Keeper — использую её

  • сергей

    А как собственно ее скачать? ссылки не вижу(