[fedora-websites] #24: Documentation is hard to find

fedora-websites trac at fedorahosted.org
Fri Jun 11 08:36:29 UTC 2010


#24: Documentation is hard to find
---------------------+------------------------------------------------------
 Reporter:  kparal   |       Owner:  webmaster
     Type:  defect   |      Status:  new      
 Priority:  major    |   Milestone:           
Component:  General  |     Version:           
 Keywords:           |  
---------------------+------------------------------------------------------
 I have opened http://docs.fedoraproject.org and I wanted to see an
 installation guide. I was completely confused, because I have found no
 documentation except "Welcome" page. I skipped the welcome page text (of
 course) and look for some menu of documentation files. Nothing, nowhere. I
 quickly scanned the hyperlinks on the welcome page - nothing that would
 help me. I was completely confused. I continued to search for *anything*
 that would lead me to documentation, and after some time I was forced to
 read the whole Welcome page to see if there is some hint per chance. Only
 after that I understood that the inconspicuous grey-ish "Fedora" text
 label on the left side of the screen is an expandable menu item. I clicked
 on it and "aaah!" finally found the documentation.

 This is a very bad user experience.

 See the screenshot how the page looks for me (default.png).

 The fix is simple. Communicate clearly that the Fedora item is expandable.
 At least put a triangle icon to it. Much better would be automatically
 expanding the documentation for latest Fedora release. See the screenshot
 (better.png). It if looks this way by default, nobody would have to spend
 long time looking where the documentation is hidden or even leaving
 without having found it.

-- 
Ticket URL: <https://fedorahosted.org/fedora-websites/ticket/24>
fedora-websites <https://fedoraproject.org/wiki/Websites>
Fedora Website Team's Trac instance


More information about the websites mailing list