[gentoo-dev] New website: Where the .... is the ....ing documentation link?

[gentoo-dev] New website: Where the .... is the ....ing documentation link?

[Duncan]

TL;DR:  (1) Please consider either making Documentation a top-level-menu 
link (preferable), or at least change Support to Support and 
Documentation.  (2) On the documentation lander page, add a "one big 
list" link to a browser-keyword-searchable list of docs, like the old 
docs project page had.

Looking for the news glep to double-check the title header max char limit 
(for the shorewall news-item thread was the first time I've had to use 
the new website.

I *HATE* it!  It's a NIGHTMARE to navigate, compared to the old one!

There's all this nice fuzzy buzzword bingo, but actually FINDING anything 
like DOCUMENTATION is an exercise in frustration!

OK, no direct docs link.  Well, "getting started" should have a nice 
documentation link, since you don't get far on gentoo without docs... No, 
not there...  Well then, "learn more" CERTAINLY must lead to 
documentation allowing you to do just that!... BLECH!!!  NO!!!  Nothing 
there but more buzzword bingo (and a contact link and links to share more 
of my interests with privacy-insensitive corporations that already know 
too much about me at the bottom).  OK, OK, Get involved must SURELY have 
that doc link, since people will need some documentation in ordered to do 
so!... Ugh, another rabbit trail... Oh, DUH!  Must be under SUPPORT!  OK, 
there it is!

But even if I KNOW to look under support, it's STILL two clicks to 
documentation, where it WAS just one!

And once on the documentation page, again, a whole bunch of fuzzy 
categories!  Where's the "one big list" link, where a simple browser 
keyword search will immediately find the document for configuring gentoo 
for whatever fancy technology you're wanting to get up and running, be it 
something fancy like mdraid or lvm, or more basic like one's init system 
of choice or sound or OpenGL?

But at least put a nice direct one-click link to docs direct on the front 
page.  Please?

(Tho unless it's directly in the main copy, I guess it'd still be two, 
since you have to click that weird icon with no actual words saying it's 
a menu, to open that, before you actually click what you want... *IF* you 
can actually find or guess what it's called... on the waaayyy too vague 
menu.)

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman

Re: [gentoo-dev] New website: Where the .... is the ....ing documentation link?

[Daniel Campbell]

On 04/04/2015 09:42 PM, Duncan wrote:
> TL;DR:  (1) Please consider either making Documentation a top-level-menu 
> link (preferable), or at least change Support to Support and 
> Documentation.  (2) On the documentation lander page, add a "one big 
> list" link to a browser-keyword-searchable list of docs, like the old 
> docs project page had.
> 
> Looking for the news glep to double-check the title header max char limit 
> (for the shorewall news-item thread was the first time I've had to use 
> the new website.
> 
> I *HATE* it!  It's a NIGHTMARE to navigate, compared to the old one!
> 
> There's all this nice fuzzy buzzword bingo, but actually FINDING anything 
> like DOCUMENTATION is an exercise in frustration!
> 
> OK, no direct docs link.  Well, "getting started" should have a nice 
> documentation link, since you don't get far on gentoo without docs... No, 
> not there...  Well then, "learn more" CERTAINLY must lead to 
> documentation allowing you to do just that!... BLECH!!!  NO!!!  Nothing 
> there but more buzzword bingo (and a contact link and links to share more 
> of my interests with privacy-insensitive corporations that already know 
> too much about me at the bottom).  OK, OK, Get involved must SURELY have 
> that doc link, since people will need some documentation in ordered to do 
> so!... Ugh, another rabbit trail... Oh, DUH!  Must be under SUPPORT!  OK, 
> there it is!
> 
> But even if I KNOW to look under support, it's STILL two clicks to 
> documentation, where it WAS just one!
> 
> And once on the documentation page, again, a whole bunch of fuzzy 
> categories!  Where's the "one big list" link, where a simple browser 
> keyword search will immediately find the document for configuring gentoo 
> for whatever fancy technology you're wanting to get up and running, be it 
> something fancy like mdraid or lvm, or more basic like one's init system 
> of choice or sound or OpenGL?
> 
> But at least put a nice direct one-click link to docs direct on the front 
> page.  Please?
> 
> (Tho unless it's directly in the main copy, I guess it'd still be two, 
> since you have to click that weird icon with no actual words saying it's 
> a menu, to open that, before you actually click what you want... *IF* you 
> can actually find or guess what it's called... on the waaayyy too vague 
> menu.)
> 

In case others have trouble: it's under Support -> Documentation. It
leads you to a page that lets you search the wiki, or pick the category
your needs fit under.

I found it without issue, and I hadn't used the new layout yet. Aside
from the Devmanual, most of Gentoo's docs are on the wiki, so you could
make a bookmark and setup a search shortcut for it. Just bookmark the
following address in Firefox:

https://wiki.gentoo.org/index.php?search=%s

Give it a keyword like 'gdocs' or something, then you can do "gdocs
Alsa" and it'll search the wiki for ALSA. I'm not sure how it's done in
Opera or Chrom[e|ium].

Re: [gentoo-dev] New website: Where the .... is the ....ing documentation link?

[Alec Warner]

[-- Attachment #1: Type: text/plain, Size: 2671 bytes --]

On Sat, Apr 4, 2015 at 9:42 PM, Duncan <1i5t5.duncan@cox.net> wrote:

> TL;DR:  (1) Please consider either making Documentation a top-level-menu
> link (preferable), or at least change Support to Support and
> Documentation.  (2) On the documentation lander page, add a "one big
> list" link to a browser-keyword-searchable list of docs, like the old
> docs project page had.
>

File a bug, the bug tracker is at https://bugs.gentoo.org. I believe there
is even a specific component for the website.


>
> Looking for the news glep to double-check the title header max char limit
> (for the shorewall news-item thread was the first time I've had to use
> the new website.
>
> I *HATE* it!  It's a NIGHTMARE to navigate, compared to the old one!
>
> There's all this nice fuzzy buzzword bingo, but actually FINDING anything
> like DOCUMENTATION is an exercise in frustration!
>
> OK, no direct docs link.  Well, "getting started" should have a nice
> documentation link, since you don't get far on gentoo without docs... No,
> not there...  Well then, "learn more" CERTAINLY must lead to
> documentation allowing you to do just that!... BLECH!!!  NO!!!  Nothing
> there but more buzzword bingo (and a contact link and links to share more
> of my interests with privacy-insensitive corporations that already know
> too much about me at the bottom).  OK, OK, Get involved must SURELY have
> that doc link, since people will need some documentation in ordered to do
> so!... Ugh, another rabbit trail... Oh, DUH!  Must be under SUPPORT!  OK,
> there it is!
>
> But even if I KNOW to look under support, it's STILL two clicks to
> documentation, where it WAS just one!
>
> And once on the documentation page, again, a whole bunch of fuzzy
> categories!  Where's the "one big list" link, where a simple browser
> keyword search will immediately find the document for configuring gentoo
> for whatever fancy technology you're wanting to get up and running, be it
> something fancy like mdraid or lvm, or more basic like one's init system
> of choice or sound or OpenGL?
>
> But at least put a nice direct one-click link to docs direct on the front
> page.  Please?
>

No need to shout.


>
> (Tho unless it's directly in the main copy, I guess it'd still be two,
> since you have to click that weird icon with no actual words saying it's
> a menu, to open that, before you actually click what you want... *IF* you
> can actually find or guess what it's called... on the waaayyy too vague
> menu.)
>
> --
> Duncan - List replies preferred.   No HTML msgs.
> "Every nonfree program has a lord, a master --
> and if you use the program, he is your master."  Richard Stallman
>
>
>

[-- Attachment #2: Type: text/html, Size: 3630 bytes --]

[gentoo-dev] Re: New website: Where the .... is the ....ing documentation link?

[Duncan]

Daniel Campbell posted on Sat, 04 Apr 2015 22:58:40 -0700 as excerpted:

> Aside from the Devmanual, most of Gentoo's docs are on the wiki, so you
> could make a bookmark and setup a search shortcut for it. Just bookmark
> the following address in Firefox:
> 
> https://wiki.gentoo.org/index.php?search=%s
> 
> Give it a keyword like 'gdocs' or something, then you can do "gdocs
> Alsa" and it'll search the wiki for ALSA. I'm not sure how it's done in
> Opera or Chrom[e|ium].

Thanks very much! =:^)

I use kde's krunner for such searches, but setting that up is very 
similar, once you have a working URL to substitute the search into.  You 
provided just that, which I hadn't thought of, so =:^)

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman

[gentoo-dev] Re: New website: Where the .... is the ....ing documentation link?

[Duncan]

Alec Warner posted on Sun, 05 Apr 2015 09:33:24 -0700 as excerpted:

> No need to shout.

Apology to you and others.  And thanks.

While I am of course familiar with CAPS=shout, I always considered it 
entire phrases or whole sentences in caps, not single words, which was 
simply emphasis.

But it seems others consider even single caps-words shouting, so from now 
on I'll try to use either *bold* or /italics/ emphasis instead.

Also, as I was reminded, a bug would have been more appropriate.  If 
events don't make it unnecessary, I'll try to file one later this week.

Thanks again.

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman

Re: [gentoo-dev] Re: New website: Where the .... is the ....ing documentation link?

[Ian Delaney]

On Mon, 6 Apr 2015 05:10:30 +0000 (UTC)
Duncan <1i5t5.duncan@cox.net> wrote:

> Alec Warner posted on Sun, 05 Apr 2015 09:33:24 -0700 as excerpted:
> 
> > No need to shout.
> 
> Apology to you and others.  And thanks.
> 
> While I am of course familiar with CAPS=shout, I always considered it 
> entire phrases or whole sentences in caps, not single words, which
> was simply emphasis.
> 
> But it seems others consider even single caps-words shouting, so from
> now on I'll try to use either *bold* or /italics/ emphasis instead.
> 
> Also, as I was reminded, a bug would have been more appropriate.  If 
> events don't make it unnecessary, I'll try to file one later this
> week.
> 
> Thanks again.
> 

Personally I found your post most entertaining and had me riti (rolling
in the isles). Like the use of cap, humour is rather an inexact science

-- 
kind regards

Ian Delaney

[gentoo-dev] Re: New website: Where the .... is the ....ing documentation link?

[Duncan]

Ian Delaney posted on Tue, 07 Apr 2015 16:02:39 +0800 as excerpted:

> Personally I found your post most entertaining and had me riti (rolling
> in the isles). Like the use of cap, humour is rather an inexact science

Thanks.  That's the way it was intended, haha but serious, making the 
point in what was intended to be a funny way.  But as people who forget 
the sarcasm tags so often find out to their misfortune, forgetting the 
humor tags can just as effectively create a lead balloon. =:^(

Glad someone took it as intended, and for those that didn't, the previous 
apology stands...  Mistake, made, apologized for.

As for the bug, looks like events overtook my need to file one.

Thanks, website team. =:^)

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman

Re: [gentoo-dev] Re: New website: Where the .... is the ....ing documentation link?

[Ian Delaney]

On Wed, 8 Apr 2015 00:11:56 +0000 (UTC)
Duncan <1i5t5.duncan@cox.net> wrote:

> Ian Delaney posted on Tue, 07 Apr 2015 16:02:39 +0800 as excerpted:
> 
> > Personally I found your post most entertaining and had me riti
> > (rolling in the isles). Like the use of cap, humour is rather an
> > inexact science
> 
> Thanks.  That's the way it was intended, haha but serious, making the 
> point in what was intended to be a funny way.  But as people who
> forget the sarcasm tags so often find out to their misfortune,
> forgetting the humor tags can just as effectively create a lead
> balloon. =:^(
> 
> Glad someone took it as intended, and for those that didn't, the
> previous apology stands...  Mistake, made, apologized for.
> 
> As for the bug, looks like events overtook my need to file one.
> 
> Thanks, website team. =:^)
> 

I think you've apologised enough. Shame it was required to state the
obvious.

-- 
kind regards

Ian Delaney