[docs] ссылка на документацию в меню

Artem Zolochevskiy =?iso-8859-1?q?artem=2Ezolochevskiy_=CE=C1_gmail=2Ecom?=
Пн Май 5 12:52:46 MSD 2008


hi all

Давайте определимся на что мы будем/не будем ссылаться в меню и может быть на 
рабочем столе.

Ситуация сейчас такая:
Есть ссылка и в меню и на раб столе, показывающая 
на /usr/share/doc/alt-docs/index.html (пакет alt-docs-main)

Мне кажется данное поведение совершенно неоправданным.
Данная страничка чвляется "собирательной". Т.е. если установлено более одного 
docs-issue они там все будут перечислены. Т.е. считать это отправной точкой 
для документации не очень верно.

Мне кажется более высокий приоритет должны иметь indexhtml-пакеты (которые в 
обязательном порядке должны иметь ссылку 
на /usr/share/doc/alt-docs/index.html

indexhtml-пакет является именно тем логичным местом, откуда надо начинать свой 
путь по "развалам" документации.

Однако с ними (indexhtml-пакетами) вот какая ситуация. По умолчанию они не 
прописаны нигде, кроме как дефолтной страничке браузера. А это легко 
пользователем может быть даже не преднамеренно изменено. Итог -- 
это "начальную" страничку отыскать просто нереально. В меню то её нигде нет.

Моё предложение такое. Считать именно indexhtml-страники отправной точкой 
документации (что собственно и должно быть по самой задумке существования 
этих пакетов). А посему ссылаться в меню (и возможно на раб столе?) именно на 
indexhtml-страники (indexhtml-пакеты) и не на alt-docs-main. При этом 
indexhtml-страники в обязательном порядке должны содержать ссылку 
на  /usr/share/doc/alt-docs/index.html (эта страница содержит список _всей_ 
документации: _все_ модули + _все_ выпуски). Ссылаться же сходу (в меню) 
на  /usr/share/doc/alt-docs/index.html  как мне кажется не совсем верно. 
Глаза могут разбежаться и можно ненароком на документацию не от своего 
дистрибутива загулять (утрирую).

-- 
Артём Золочевский


Подробная информация о списке рассылки docs