Hi,

On Sun, 2023-08-06 at 10:57 +0200, Thomas Lange wrote:
> > > > > > On Sat, 15 Jul 2023 16:17:09 +0200, Holger Wansing
> > > > > > <hwans...@mailbox.org> said:
> 
>     > https://www.debian.org/support.en.html is named 
>     > "Getting help and documentation" !!!
>     > So people are pointed to the support page, when they look for
> documentation.
>     > And then they find - nothing (about docs)!
> As already pointed out, the link to the documentation is in the grey
> box on the /support page which should get more attention, because it's
> not only a link inside text but inside a graphical element.

After you pointed out, I saw it.  Me and Holger missed the link you thought is
highlighted.  So your intension is not working as expected to some people.

TBH, it's in gray area with long sentence, I didn't realize I need to look for
one linked word there. I expected to see some footnote/reminder type pointer
there.

I expected link to doc/ in main list.

Gray box should be there as supplemental info so people can be guided.

> We also have a link to /doc when you click any of the "More" menu on
> the front page.

This is true but "More" page is totally irrelevant to our current discussion.

People find "User Support" with "Getting help and documentation" in the front
page and click into https://www.debian.org/support.en.html to see "help" and
"documentation".  So discussion is how to lead people reading "support" page to 
"help" and "documentation".

>  And if you search for "debian documentation" in a
> search engine, you will be directly pointed to the right link.

Let me skip arguing on this point.  

Let's think about consistent web page organization design within current Debian
web site.  I checked 6 similar pages linked from the main page.

## People

Gray box is supplemental information  (Not highlighted key information) as:

    Since many people have asked: Debian is pronounced /ˈde.bi.ən/. It's named  
   after the creator of Debian, Ian Murdock, and his wife, Debra.

## Our Philosophy

Gray box has "Social Contract".  But more importantly, main text also has link
to "Social Contract".

By **repeating**  in 2 places in a page, "Social Contract" is getting more
attention.       

## Get Involved, Contribute

This is similar situation as "User Support".

IMHO, in the section "Contribute", there should be a bulleted line something
along "Contribute via sponsor" added to the list to give better idea for
readers.

## Why Debian

* There are several Gray boxes but their contents are all side story examples.

## User Support

* Gray box contain key link embedded in long sentence.
* Main text lacks link to doc/


## Security Updates

The gray box is summary statement.  Key information links are all in main page.

Osamu

Reply via email to