Обновления для тех, кто использует самохостинг
Для пользователей самохостинга, использующих этот плагин, наше последнее обновление потребует ручной пересборки индекса. Это потребует выполнения следующей задачи Rake:
bundle exec rake doc_categories:build_sidebar
# если выполнение задачи выше завершается ошибкой NoDatabaseError,
# выполните её со следующими параметрами для типичных самохостинговых настроек
sudo -E -u discourse bundle exec rake doc_categories:build_sidebar
Если вы не можете выполнить эту задачу Rake, вы можете перейти в настройки каждой категории документации, удалить индекс категории, сохранить изменения, добавить его обратно и снова сохранить. Это пересоберёт их и обновит кэш категорий.
Почему мы это делаем?
Ранее, когда боковую панель нужно было заполнить, мы парсили каждый индексный материал на лету и кэшировали их. Это обновление переносит существующие индексы на базу данных вместо использования материалов. Это даёт нашей команде больше возможностей при поиске способов улучшения UX организации индекса.