[docs] Re: mozilla.ru

[Alexandre Prokoudine]

On Mon, 17 Mar 2003 20:11:08 +0300
aen <aen на altlinux.ru> wrote:

> Vitaly Ostanin пишет:
> 
> >On Mon, 17 Mar 2003 19:14:04 +0300
> >Vadim Vinichenko <vnv на 14000.ru> wrote:
> >
> ><skipped/>
> >
> >  
> >
> >>>http://www.mozilla.ru/wnew/index.html
> >>>И страницы с подробными описаниями.
> >>>
> >>>      
> >>>
> >>Предполагается, что этот материал будет интегрирован в
> >>существующие главы про Mozilla (они сейчас находятся на уровне
> >>версии 1.2).
> >>
> >>С другой стороны, я предполагаю, используя в качестве отправной
> >>точки существующий документ про 1.3, постепенно собирать
> >>коллекцию небольших лоскутков про разные Cool Features of
> >>Mozilla, безотносительно к версии. Она будет жить и развиваться
> >>где-то в Интернете (вероятно, на mozilla.ru или в
> >>окрестностях). Собственно, эта коллекция по содержанию будет
> >>почти полностью представлять собой подмножество руководства из
> >>CVS, только организована будет по другому, и картинок,
> >>возможно, будет побольше:-).
> >>    
> >>
> >
> >Ясно :) Кстати, количество картинок можно регулировать
> >автоматически :)
> >
> >  
> >
> Мне хотелось бы теперь плавно закруглить тему, которую поднял
> Rider, тем более, что мы с ним сейчас ее обсудили в офисе.
> На самом деле, речь идет не о вытеснении "консольных" приложений
> из  user, а о плохом качестве документации по KDE и GNOME. Rider
> считает, что они для домохозяет, мне же кажется, что они просто ни
> для кого.  И именно их надо  -- переделывать, а, может быть,
> просто выкидывать. Каким должно быть руководство по
> пользовательсскому интерфейсу для _наших_ пользователей, среди
> которых нет домохозяек (не в смысле рода занятий, а в том смысле,
> который обычно вкладывают в это понятие)? Я не готов сейчас дать
> ответ, но могу привести  в качестве примера статью Вадима про
> новое в mozilla-1.3. Есть и второй пример, -- лекции, автором
> которых являестя участник этого списка, но они еще не
> опубликованы. Видимо, надо описывать характерные приемы и
> особенности работы с интерфейсом, а не то, что и так интуитивно
> ясно или быстро становится ясно. Возможно, надо просто задаться
> целью собрать tips&tricks, а дальше, если будут время/силы
> нарастить мясо на этот костяк, но не слишком много.
> В такую пользовательскую документацию руководства по bash, vim
> etc. войдут органичнее.
> 
> Мнения?

Я уже давно говорю о том, что идеальная документация:

1. Краткое описание основных возможностей программы и принципов
её работы

2. Решение типовых задач с помощью программы (1-3 примера --- по
необходимости)

3. Список полезной для ознакомления литературы по теме

Эта именно та схема, на которую я хотел бы перевести всю или почти
всю документацию

-- 
Alexandre Prokoudine
ALT Linux Documentation Team
JID: avp на altlinux.org