Re: Debian Reference
On Fri, Nov 08, 2002 at 06:20:53PM +0700, Rahmat M. Samik-Ibrahim wrote:
> (CC: to Debian Webmasters and DEBID, hopefully you don't mind).
>
> Osamu Aoki wrote:
>
> >>>> http://debid.vLSM.org/
> >>>> http://debid.vLSM.org/share/Debian-Doc/manuals/debian-reference/examples/
>
> >>> BTW, if you have critique suggestion on the content of the document,
> >>> please let me know by personal mail or as a bug to the package.
>
> >> My concern is about 'visibility'; i.e. it not so obvious that
> >> "Debian Reference" exists; as well as it is a very useful resource.
> > [...]
> > It is only 3 clicks
> > Documentation -> Debian Reference -> Choices of formats -> document
>
> Well, my URL above is ONE click and NO scroll away -- whereas yours are many
> clicks and many scrolls ways. How would you expect someone hits that
> **VERY IMPORTANT** and **VERY USEFUL** reference page if it is so hidden ;-(?
Thanks. If you post message of this kind to debian-www, it will be
helpful. It is not MY site. My site is QREF.SF.NET which has big
penguin and one click to all document formats.
> >> In regard of Debian Reference itself, the example/ directory is
> >> not so visible.
> > Well in convention (Chapter 1, I have link there.)
>
> And it is expected that a clueless novice reads the "convention" section at the
> first time? I --myself-- did not realize the existence of that examples/
> directory until you mentioned it in the "debian-user" list sometimes ago.
>
> >> Suggestion: ADD a large red "EXAMPLE" button at the front/table of contents
> >> page.
> > Debiandoc-sgml does not have button :-(
> > Let me think....
>
> How about to put a bold font "example" section in the abstract section?
Hey you hit the sweet spot. Sure it deservre a section title !!!
I will.
> regards,
>
> PS:
>
> - dear webmasters: I would like to suggest a new "HELP/NOVICE" page with
> a RED BOTTON link at the page headers.
Hmmm, this suggestion will be politically correct one to make (not
just my document. I am thinking to include hands-on guide to be on
debian too which is more novice oriented.
Osamu
--
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
Osamu Aoki <osamu@debian.org> Cupertino CA USA, GPG-key: A8061F32
.''`. Debian Reference: post-installation user's guide for non-developers
: :' : http://qref.sf.net and http://people.debian.org/~osamu
`. `' "Our Priorities are Our Users and Free Software" --- Social Contract
Reply to: