Solved FreeBSD Forums header area (above the Forums button) directing readers to oudated content (outdated Handbook, and so on)

vigole

Daemon

Reaction score: 1,234
Messages: 1,140

FreeBSD website is doc/website part of FreeBSD Documentation Project (FDP). It's not Forums' fault, as far as I can tell.
 

gnath

Active Member

Reaction score: 45
Messages: 186

The specified handbook contains a line " The latest version of this book is available from the FreeBSD website." The link from Freebsd web site provides the latest version of Handbook.
 
OP
grahamperrin

grahamperrin

Aspiring Daemon

Reaction score: 189
Messages: 643

FreeBSD website is doc/website

Sorry, I misread that as FreeBSD Forums.

https://cgit.freebsd.org/doc/tree/website at a glance, I see nothing Forums-related; and https://cgit.freebsd.org/doc/log/website?qt=grep&q=forum finds nothing.

To clarify, I'm referring to the links under Documentation at FreeBSD Forums:

2021-04-05 11:02:09.png
 

vigole

Daemon

Reaction score: 1,234
Messages: 1,140

I'm not sure how XenForo works. To be precise, I don't know how Forums generates the menu, i.e. is it a scraping from the website src or a customised copy.
 

Zirias

Daemon

Reaction score: 1,318
Messages: 2,344

And no matter how it's done, it's probably a problem with forums. Either there's some automatic mechanism, then, this is obviously broken as the links didn't change just yesterday. Or it's a manual task, then it was just forgotten to carry out ;)
 

vigole

Daemon

Reaction score: 1,234
Messages: 1,140

What issue? You're on the Forums page. People expect to go to the home page, when they click on Logo. In this case, Forums! The only unresolved issue:
This thread is still open.
 
OP
grahamperrin

grahamperrin

Aspiring Daemon

Reaction score: 189
Messages: 643

mtu

Active Member

Reaction score: 65
Messages: 117

I agree: A good number of the links in the top menu of forums.freebsd.org are outdated or broken. This should be something for the attention of SirDice or DutchDaemon.
 

mtu

Active Member

Reaction score: 65
Messages: 117

What issue? You're on the Forums page. People expect to go to the home page, when they click on Logo. In this case, Forums! The only unresolved issue:
This thread is still open.
There's a misunderstanding here. Here's two examples of the problem, clearly marked.
 

Attachments

  • forums_links1.jpg
    forums_links1.jpg
    116.8 KB · Views: 22
  • forums_links2.jpg
    forums_links2.jpg
    106.6 KB · Views: 24
OP
grahamperrin

grahamperrin

Aspiring Daemon

Reaction score: 189
Messages: 643

Thank you.
There's now a longer title for this topic; emphasis on the FreeBSD Forums header area (above the Forums button)
 

vigole

Daemon

Reaction score: 1,234
Messages: 1,140

1. "forums.freebsd.org" is not part of FDP i.e. /doc (web, docs) + manages in the base.
2. Although it happend that the "forums.freebsd.org" is a subdomain of the FreeBSD.org, but you have to think of it as a different website. e.g. "ForumsFreeBSD[.]org"
3. This Forums like every single other Forums has a navigation menu/bar (New posts, CP, etc) and of course a "Home" item too.
4. Traditionally, both "Home" AND "Logo" will "href" to the 1st page.
5. BUT: FreeBSD Forums provides an additional menu -- copied from FreeBSD.org. Why? To help users finding their way through the docs, man, src, etc.
6. Thus, now we have two menus: the 1st one, which is the "forums.freebsd.org" menu (New posts, user profile, etc), and the others is an auxiliary menu to the "FreeBSD.org".
7. BUT! now we have two "Home" items. One for "forums.freebsd.org", and another one for the "FreeBSD.org".

What's the solution?

* Most people are not Forums member -- they visit the FreeBSD.org. So they expect, "Home" item send them to the 1st page of the "FreeBSD.org".
===> "Home" item --> FreeBSD.org

* Forums members need a way to reach, to the home page of the Forums.
===> "Logo" -------> forums.FreeBSD.org

And to me, the whole thing makes perfect sense.
 

Zirias

Daemon

Reaction score: 1,318
Messages: 2,344

You can debate a lot where the main logo should link to, there's good arguments for both approaches.

But outdated links (especially to an outdated handbook) in the top menu definitely are an issue.
 

Zirias

Daemon

Reaction score: 1,318
Messages: 2,344

vigole

Daemon

Reaction score: 1,234
Messages: 1,140

Which brings it up to the my first point: this whole thread is barking up the wrong tree
 

Zirias

Daemon

Reaction score: 1,318
Messages: 2,344

Really? Having a lot of links that are different from the same menu on the authorative main site is somehow someone else's problem? Just, no.
 
  • Like
Reactions: mtu

Jose

Aspiring Daemon

Reaction score: 789
Messages: 938

Zirias

Daemon

Reaction score: 1,318
Messages: 2,344

I vaguely remember reading about this on freebsd-ports. It has something to do with the transition to Asciidoc. The /en links are the preferred ones, IIRC.
Part of the problem is that the old documents are still there, but no longer updated. Doing something about that is clearly out of scope for the forums, but would be very desirable, especially considering Google finds the old documents…

Still, what's in the scope of forums is fixing the links here, it really shouldn't link to an outdated handbook.
 
Top