[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