Page MenuHomeFreeBSD

website: complete refresh of beastie theme
Needs ReviewPublic

Authored by mark_freebsdfoundation.org on Tue, Nov 25, 11:26 PM.
Tags
None
Referenced Files
F138012912: D53910.diff
Fri, Nov 28, 3:47 AM
F137967454: D53910.diff
Thu, Nov 27, 6:29 PM
F137964653: D53910.diff
Thu, Nov 27, 6:00 PM
Unknown Object (File)
Wed, Nov 26, 2:17 PM
Unknown Object (File)
Wed, Nov 26, 11:08 AM
Unknown Object (File)
Wed, Nov 26, 7:53 AM
Unknown Object (File)
Wed, Nov 26, 3:57 AM
Subscribers

Details

Reviewers
bcr
dch
lwhsu
Group Reviewers
doceng
Summary

Sponsored by: The FreeBSD Foundation

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 68874
Build 65757: arc lint + arc unit

Event Timeline

I owe a deeper explanation for the purpose of this large drop. This is work Mark McBride, and to an extent Sergio, have been working on almost all year. The reason I have got involved is because a) I know Hugo b) it feeds the sole purpose of my job for this year — prove to the world FreeBSD is not dying or dead. There is no escaping the fact people do "judge a book by its cover", despite being told, no doubt by our parents, not to. Our 'book cover' is the website, and it says "FreeBSD is dead". It looks like it's not been touched in years, because speaking of metaphorical 'paint', it hasn't. We need to modernise the website inline with the docs site — which does look modern and loved.

Sergio has clearly been busy this year and has not been able to tend to an idea he proffered in 2023 — to modernise the main site. Mark McBride, an enthusiastic and hard working community member, spent hours polishing the site and canvassed lots of opinions on social channels. Sergio popped up a couple of months ago, and suggested we align the header and footer with the docs site, which is the work I have picked up.

There are no structural or technical changes here — this is a lick of paint. Nothing changes in the way people will edit the site day to day. What they will get is a modern looking homepage that supports dark mode and is responsive (yes, it looks correct on mobiles, tablets and desktops!)

There will be iterations on this post-drop, but for now it is functionally correct (I've crawled it with Screamingfrog to check for dead links) and it works in both localhost testing and on a live domain. It supports the existing two languages on the homepage, but has the scope to add all the language support the docs site has.

What I'm asking for, and have been asking for for months, is a pragmatic view to getting this delivered for 15.0 dropping next week. We send a cohesive message to the world that FreeBSD is very much alive, technically, and in appearances. Marketing, if you will. Or as I prefer we all refer to it in our technical community, "storytelling". This is the story of an alive, well tended to, product.

Kudos to a lot of this work must go to Mark McBride. I just shuffled Sergio's work from docs into Mark's work. I am but the glue between the hard work of these two chaps then :)

I have next comments regarding new theme.
It is good to have light and dark themes.

What is desired - the current home page has language switch in the top-right corner, it is visible and easy to find. Could you consider to place similar switch in new theme? The switch in the bottom of the page is not comfortable even for experienced FreeBSD users.

Need to fix:

  1. the home page has news, advisories, error notes, press and events columns. Now they do not have headings. I translated them some time ago, and even for me it was not easy to understand what is where. Could you add headings for these areas?
  2. These areas have link with text "More". It is the same in all languages now - in English. I hope it has option to be translated. In current site this word is translated (keyword changed, probably in toml file, we will find it).
  3. news/newsflash/ (News) page has years and days , but months are missing in dates. Press and Events has the same issue - no months, it is not big problem, date appears in text message, but it was more visible with months too.
  4. home page has buttons to download version 14.3, button "Other" points to where/#download, but page 'where' does not have anchor #download. It has id="download" in <h3> tag, that is not interpreted as anchor by browsers (checked in Chrome and Safari). It is excelent idea to point this place in the where page, but this page needs anchor in this place.
  5. Top menu - in About menu first 2 submenu point to /about page. Could be other additional page added? Or maybe other page expected in FreeBSD submenu?
  6. In Documentation menu after submenu FreeBSD Handbook long vertical interval to the next submenu
  7. missing the links to the pages, that are interesting for site visitors:

https://www.freebsd.org/features/ - Features
https://www.freebsd.org/projects/newbies/ - Introduction
https://www.freebsd.org/projects/ - Projects
https://www.freebsd.org/usergroups/ - Usergroups in Community menu
Developers menu - information for new contributors, who want to join.
https://www.freebsd.org/commercial/ - Vendors.

I hope these comments do diminish the major effort put into supporting the new style. Keep moving.

Also comment regarding patch: file website/themes/beastie/static/images/freebsd-official.svg has '\ No newline at end of file' message in the patch file. 'patch' in my system stops processing diff after this message, next files were not applied, it silently skips the rest of the file (or reports 'garbadge found, skip the rest' in verbose mode). It took time to find way to apply this patch correctly. Could you fix this svg file? Other svg files do not have this message.