Gentoo Archives: gentoo-dev

From: Alec Warner <antarus@g.o>
To: Gentoo Dev <gentoo-dev@l.g.o>
Subject: Re: [gentoo-dev] New website: Where the .... is the ....ing documentation link?
Date: Sun, 05 Apr 2015 16:33:32
Message-Id: CAAr7Pr_z=pv23LiSoNn3r2tWeChTt6PBxaiDjniN-P4Lj63Hmg@mail.gmail.com
In Reply to: [gentoo-dev] New website: Where the .... is the ....ing documentation link? by Duncan <1i5t5.duncan@cox.net>
1 On Sat, Apr 4, 2015 at 9:42 PM, Duncan <1i5t5.duncan@×××.net> wrote:
2
3 > TL;DR: (1) Please consider either making Documentation a top-level-menu
4 > link (preferable), or at least change Support to Support and
5 > Documentation. (2) On the documentation lander page, add a "one big
6 > list" link to a browser-keyword-searchable list of docs, like the old
7 > docs project page had.
8 >
9
10 File a bug, the bug tracker is at https://bugs.gentoo.org. I believe there
11 is even a specific component for the website.
12
13
14 >
15 > Looking for the news glep to double-check the title header max char limit
16 > (for the shorewall news-item thread was the first time I've had to use
17 > the new website.
18 >
19 > I *HATE* it! It's a NIGHTMARE to navigate, compared to the old one!
20 >
21 > There's all this nice fuzzy buzzword bingo, but actually FINDING anything
22 > like DOCUMENTATION is an exercise in frustration!
23 >
24 > OK, no direct docs link. Well, "getting started" should have a nice
25 > documentation link, since you don't get far on gentoo without docs... No,
26 > not there... Well then, "learn more" CERTAINLY must lead to
27 > documentation allowing you to do just that!... BLECH!!! NO!!! Nothing
28 > there but more buzzword bingo (and a contact link and links to share more
29 > of my interests with privacy-insensitive corporations that already know
30 > too much about me at the bottom). OK, OK, Get involved must SURELY have
31 > that doc link, since people will need some documentation in ordered to do
32 > so!... Ugh, another rabbit trail... Oh, DUH! Must be under SUPPORT! OK,
33 > there it is!
34 >
35 > But even if I KNOW to look under support, it's STILL two clicks to
36 > documentation, where it WAS just one!
37 >
38 > And once on the documentation page, again, a whole bunch of fuzzy
39 > categories! Where's the "one big list" link, where a simple browser
40 > keyword search will immediately find the document for configuring gentoo
41 > for whatever fancy technology you're wanting to get up and running, be it
42 > something fancy like mdraid or lvm, or more basic like one's init system
43 > of choice or sound or OpenGL?
44 >
45 > But at least put a nice direct one-click link to docs direct on the front
46 > page. Please?
47 >
48
49 No need to shout.
50
51
52 >
53 > (Tho unless it's directly in the main copy, I guess it'd still be two,
54 > since you have to click that weird icon with no actual words saying it's
55 > a menu, to open that, before you actually click what you want... *IF* you
56 > can actually find or guess what it's called... on the waaayyy too vague
57 > menu.)
58 >
59 > --
60 > Duncan - List replies preferred. No HTML msgs.
61 > "Every nonfree program has a lord, a master --
62 > and if you use the program, he is your master." Richard Stallman
63 >
64 >
65 >

Replies