Нейросеть‑ябеда, 6000 протоколов из облака и еще 8 плагинов DokuWiki от VAS Experts

В сфере искусственного интеллекта произошло заметное событие. VAS_Experts_Team 52 минуты назад Краткое содержание статьи Нейросеть‑ябеда, 6000 протоколов из облака и еще 8 плагинов DokuWiki от VAS Experts Простой 11 мин 929 Блог компании VAS Experts Подготовка технической документации * Сетевые технологии * Wiki-проекты * Обзор В статье «DokuWiki как платформа для технической документации: наш опыт» мы рассказали, почему ведем документацию на DokuWiki, и пообещали отдельно разобрать собственные плагины. А как вики выглядит для читателя, мы показали в статье «Как устроена Wiki VAS Experts». Теперь выполняем обещание.

Всего на нашей вики работает около 35 плагинов, 10 из них мы написали сами. Ниже расскажем, какую задачу решает каждый, как он устроен и что из этого получилось. Коротко о вики и задачахДокументация ведется на двух языках и двух площадках: около 1460 страниц на русской вики и 654 на английской.

Технические детали

Читают ее инженеры провайдеров и операторов, которые приходят за конкретным параметром или командой и хотят найти их быстро. Из этого выросли задачи, которые готовые плагины не закрывали. Наши плагины можно разделить на четыре группы:Два языка — поддерживать RU‑ и EN‑версии в актуальном состоянии и показывать в поиске только страницы на выбранном языке;Обратная связь — собирать отзывы прямо со страницы, узнавать, что читатель не нашел;Удобство чтения — сделать чтение длинных технических страниц и копирование кода удобнее;Данные из продукта — автоматически синхронизировать список протоколов в вики с VAS Cloud.

Все десять плагинов в одной таблице:ПлагинГруппаЧто делаетНа что опираетсяtranslationcompareДва языкаОценивает, актуален ли английский переводIO_WIKIPAGE_WRITE, JSON‑RPC к моделиlangsearchfilterДва языкаОставляет в поиске страницы на языке интерфейсаSEARCH_QUERY_FULLPAGE, SEARCH_QUERY_PAGELOOKUPpagefeedbackОбратная связьФорма «Была ли полезна эта информация? »TPL_ACT_RENDER, AJAX_CALL_UNKNOWNreportproblemОбратная связьКнопка «Не нашли нужную страницу? »AJAX_CALL_UNKNOWNcopycodeУдобство чтенияКнопка копирования у блоков кодаTPL_METAHEADER_OUTPUTscrollsidebarУдобство чтенияЗакрепляет боковую панель с оглавлениемТолько style.

csscleansnippetУдобство чтенияУбирает разметку из сниппетов поискаFULLTEXT_SNIPPET_CREATEsyncprotocolsДанные из продуктаСинхронизирует список протоколов из VAS CloudКонсольная команда, тег aihelperAIОтвечает на вопросы на странице поискаJSON‑RPC к моделиaitranslationAIГотовит черновик английской страницыJSON‑RPC к моделиДва языка: translationcompare и langsearchfiltertranslationcompare: актуален ли переводЗадача. Русская страница обновляется после каждого релиза, а английская может отставать на несколько версий. Уследить за этим вручную на сотнях пар страниц невозможно.

Этот прогресс даёт важные сигналы о будущем отрасли, и технологический мир внимательно наблюдает.