[docs] справка к модулям альтератора.

[Kirill Maslinsky]

On Tue, Jan 27, 2009 at 10:39:20AM +0300, Stanislav Ievlev wrote:
> On Mon, Jan 26, 2009 at 10:45:53PM +0200, Artem Zolochevskiy wrote:
> > Господа,
> > 
> > Есть мнение, что в справке _каждого_ модуля альтератора, который
> > управляет какой-то службой, надо дописать фразу о том, что после
> > настроек службу надо рестартовать.
> Да, вроде как большинство модулей сейчас именно так устроены: сначала
> конфигурим, потом перестартуем.
> Это действительно может оказаться неочевидным.
Это безусловно неочевидно. Однако мне кажется, что более правильным
с точки зрения удобства использования была бы реализация в самих 
модулях рестарта службы в случае принятия изменений в конфигурации.

Т.к. пользователь справку: 
не читает/читает невнимательно/не понимает/понимает неправильно/забывает прочитанное
в справку не стоит переделегировать часть логики работы модуля.

Так, например, как это сделано в веб-интерфейсах всяких роутеров: 
жмёшь Apply в настройках, тебя перекидывают на экран с кнопкой 
"Save&Restart". По идее можно обойтись и без второго экрана. 

-- 
Kirill Maslinsky
ALT Linux Team
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: not available
URL: <http://lists.altlinux.org/pipermail/docs/attachments/20090127/3f712286/attachment.bin>