Всё что тут написано уже обсуждено и похоже не имеет возражений, надо
только всё это дело устаканить окончательно.

1. Система справки - это отдельная система к инсталлятору/конфигуратору
идущая отдельным пакетом. Она поставляет свой backend к alterator чтобы
модули могли с ней взаимодействовать. Справку у нас пишут отдельные люди,
не те кто пишут сами модули поэтому удобнее так её и расположить.

2. alterator знать не знает и ведать не ведает, как где и по какому
принципу разложена справочная информация.

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

Это только примерный вариант, возможны другие.

Сделав запрос, получает url и дальше сообщает браузеру
(help этот-урл).

help - это просто некий псевдо-виджет, браузер сам распоряжается что ему с
этим делать.

4. Браузеру просто сообщается что модуль имеет для себя некоторую
справочную информацию и дальше дело этого браузера где её разместить:
 - или как компонент в имеющимся wizard
 - или плавно выплывающем откуда-нибудь сбоку окошке
 - или в вылетающем диалоге
 - показывать всегда или при нажатии на F1, или сделать спец. кнопку, 
   или написать про F1 в статусной строке.
 - а может вообще просто "проговорить" информацию вслух, если "попросят" ;)

--
Стас.

_______________________________________________
Devel-conf mailing list
[email protected]
https://lists.altlinux.org/mailman/listinfo/devel-conf

Ответить