[docs] ссылка на документацию в меню
Kirill Maslinsky
=?iso-8859-1?q?kirill_=CE=C1_altlinux=2Eorg?=
Вт Май 6 10:40:11 MSD 2008
On Mon, May 05, 2008 at 11:52:46AM +0300, Artem Zolochevskiy wrote:
> 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 mailing list
> docs на lists.altlinux.org
> https://lists.altlinux.org/mailman/listinfo/docs
--
Kirill Maslinsky
ALT Linux Team
Подробная информация о списке рассылки docs