Hey @bcr ! I noticed somebody mentioning ZFS in the handbook again recently (Reddit, probably) and that this fixes a lot of the grumbles. I can see it's been sat for a long time, but if it's still valid would you like to drop it? I think it would be great to sort that page 👍

Hello @carlavilla — is there anything/anybody we're waiting on to drop this? Thanks!

Thanks for reviewing @carlavilla 👍 Could you land it for me too please? Gracias!

In D53910#1305665, @adrian wrote:

Just as a general observation - and don't block landing this, but do fix this later - you can't assume that your text is going to pretty fit your widgets. This is not only for language reasons but for accessibility reasons.

Plenty of people I know will jack the font size /way/ up on desktop, tablet and phone screens.

So don't block landing on making this work, but someone's going to need to address that.

(Also, you shouldn't be making text fit specific pixel size elements, but that's again a later problem to solve and I won't block getting this landed.)

Thanks!

In D53910#1305657, @mark_freebsdfoundation.org wrote:

In D53910#1305642, @carlavilla wrote:

In D53910#1305608, @ziaee wrote:

alright. i tried building this with DOC_LANG= , public/index.html is illegible, public/en/index.html redirects to actual f.o, and make run gives a site with no header buttons except the hambuger menu.

this is normal, don't worry about it.

@mark_freebsdfoundation.org I restored the old width. I will try to make a real fix this night. Btw, I'll commit it on Friday.

Star! Thanks Sergio. I’ll bring the change in to this and push to the test site. Give me 10 minutes please 🙏

Revert CSS width.

In D53910#1305642, @carlavilla wrote:

In D53910#1305608, @ziaee wrote:

alright. i tried building this with DOC_LANG= , public/index.html is illegible, public/en/index.html redirects to actual f.o, and make run gives a site with no header buttons except the hambuger menu.

this is normal, don't worry about it.

@mark_freebsdfoundation.org I restored the old width. I will try to make a real fix this night. Btw, I'll commit it on Friday.

In D53910#1305463, @carlavilla wrote:

In D53910#1305462, @mark_freebsdfoundation.org wrote:

@carlavilla The width is too much now - I only ever get the burger menu on my laptop screen, even at max width.

yes, happened the same to me in my computer, the problem is with the Russian language only. Maybe @vladlen can help us and put a short texts

@carlavilla The width is too much now - I only ever get the burger menu on my laptop screen, even at max width.

In D53910#1305185, @carlavilla wrote:

I uploaded the last changes.
I also sent the email to core@ and doceng@

Sergio, please don't update your GH any longer, getting it in sync with this review was hard work 😃 Whatever those last changes were, either apply them after this has gone live, or put them on this review please and thank you 🙏

Catch up with Sergio's GH

Small fixes requested

In D53910#1305185, @carlavilla wrote:

In D53910#1305141, @mark_freebsdfoundation.org wrote:

In D53910#1305134, @cperciva wrote:

Is this going to land soon? I'd really like to avoid colliding with 15.1 release engineering; I bump a lot of files when the release comes out and I don't want to deal with rebase conflicts at announcement time.

@carlavilla — ship it! 😁 I've rebased on main and sorted the words on the community section.

I uploaded the last changes.
I also sent the email to core@ and doceng@

In D53910#1305266, @ziaee wrote:

The new icons look great! The new text for community is fine, but it doesn't mention research institutions. I noticed some technical things while giving it a final review.

In D53910#1305134, @cperciva wrote:

Is this going to land soon? I'd really like to avoid colliding with 15.1 release engineering; I bump a lot of files when the release comes out and I don't want to deal with rebase conflicts at announcement time.

Community words update

Rebase on main

I’ll sort the copy Sergio 👍

In D53910#1303893, @ziaee wrote:

In D53910#1303832, @jrtc27 wrote:

In D53910#1303533, @ziaee wrote:

Please understand that I am personally committed to seeing this website refresh land, however I am formally requesting changes proposed over email. I would like to propose the line objected to is replaced with "For over 30 years, this has been a grass roots project carried by passionate volunteers."

Firstly, for those of us not privy to this private email chain, what specifically is being objected to, and why?

The line "Check out the engagement driven by the FreeBSD Foundation on YouTube" is being objected to on the grounds that it is inappropriate for the "Community" box.

Secondly, I don't like this proposal. FreeBSD is where it is today because of volunteers, but it is also where it is today because of the many corporate and research entities who employ people whose jobs include improving FreeBSD. I think it also just makes the project sound unprofessional in nature.

Okay, thanks for engaging. I disagree that grass-roots volunteers is unprofessional, but do you have any alternative ideas?

Add missing logo svg

Sync with Sergio's GitHub version

@carlavilla PR for the deprecation warning fixes 👍 https://github.com/sergio-carlavilla/freebsd-new-design/pull/24

Hey @carlavilla 👋 Once @dbaio has confirmed Hugo upgrade, let's drop what you have? If it can't be loaded into this review, shall we make a new one and point to this as the history? It would be great to get it live though! 🙏

I currently have no idea why @carlavilla — but if you change to another language besides English, then click back to English, /en on the test site will redirect back to www.freebsd.org. I'm not sure where it's picking this up from, because the URL is server relative (i.e. freebsd.fortasse.cloud/en) — do you know what's happening here?

In D53910#1297766, @mark_freebsdfoundation.org wrote:

In D53910#1297543, @carlavilla wrote:

@mark_freebsdfoundation.org can you please upload the current changes to the server? Thanks!

Done!

In D53910#1297543, @carlavilla wrote:

@mark_freebsdfoundation.org can you please upload the current changes to the server? Thanks!

In D53910#1293617, @christos wrote:

Many translations (e.g., German, Danish, Polish from a quick look) are actually in English.

In D53910#1293398, @carlavilla wrote:

I removed the wiki from the documentation menu.
And yes please, if you can make the diff, upload it.

Btw, can you please deploy the last changes? I want to send the message today

Thanks!

In D53910#1293298, @carlavilla wrote:

At any rate, would you guys update the diff in this revision so we can see the diff as well?

Sure, let me update the diff

In D53910#1293294, @mark_freebsdfoundation.org wrote:

In D53910#1293282, @carlavilla wrote:

Edit: I've just noticed at least one of the sidebars - for 'administration' - has the absLangURL error too. So they'll need fixing them. I'll sort them, and a PR, later. I will deploy the fixes anyway, even before you merge.

In D53910#1293282, @carlavilla wrote:

In D53910#1293270, @mark_freebsdfoundation.org wrote:

In D53910#1293244, @carlavilla wrote:

https://github.com/sergio-carlavilla/freebsd-new-design/pull/18

Done

Just issued a PR to fix the /languages link in footer (we were missing languages.adoc in content/{en,ru,zh-tw}). There's another PR to fix the hardcoded www.freebsd.org in footer too 👍

Tell me please when the final version is deployed.
And thank you so much for your help

In D53910#1293244, @carlavilla wrote:

https://github.com/sergio-carlavilla/freebsd-new-design/pull/18

Done

In D53910#1293244, @carlavilla wrote:

@carlavilla just issued PR 18 to fix the menus (absLangURL hard codes 'www.freebsd.org', which breaks the test site. Better to use relLangURL)

https://github.com/sergio-carlavilla/freebsd-new-design/pull/18

Done

In D53910#1293239, @mark_freebsdfoundation.org wrote:

In D53910#1293199, @mark_freebsdfoundation.org wrote:

In D53910#1293177, @carlavilla wrote:

Can you please publish the current version? I made the changes and I think we can send the message at least to developers@ and see the changes they request.

Yep! Give me 10 minutes and it’ll be sorted.

Done @carlavilla 😃

In D53910#1293199, @mark_freebsdfoundation.org wrote:

In D53910#1293177, @carlavilla wrote:

Can you please publish the current version? I made the changes and I think we can send the message at least to developers@ and see the changes they request.

Yep! Give me 10 minutes and it’ll be sorted.

In D53910#1293177, @carlavilla wrote:

In D53910#1293106, @mark_freebsdfoundation.org wrote:

In D53910#1293103, @carlavilla wrote:

In D53910#1292733, @mark_freebsdfoundation.org wrote:

Hey @carlavilla I dropped a couple more PRs onto GH - quick fixes for latest versions of 14 👍

Merged.
And I am going to finish the last things.

Awesome! Thanks Sergio. If you need my help for anything over the weekend, please just ping me here and I’ll get onto it 👍

Can you please publish the current version? I made the changes and I think we can send the message at least to developers@ and see the changes they request.

In D53910#1293103, @carlavilla wrote:

In D53910#1292733, @mark_freebsdfoundation.org wrote:

Hey @carlavilla I dropped a couple more PRs onto GH - quick fixes for latest versions of 14 👍

Merged.
And I am going to finish the last things.

Hey @carlavilla I dropped a couple more PRs onto GH - quick fixes for latest versions of 14 👍

In D53910#1291274, @carlavilla wrote:

For me, one of the things we need to improve is the where page (downloads).
I think we can take the design from the design made by Mark

👍 Have you got the time this week to look at it?

This night. I want to "send" the message to developers@ this Sunday.
Then wait for feedback, fix the problems and send it to announce@.

This is what I made the last time I was involved in a new design and it was so productive

In D53910#1291146, @carlavilla wrote:

In D53910#1291144, @mark_freebsdfoundation.org wrote:

Hola @carlavilla — @grahamperrin pinged me some helpful proofreading bits late last night, which I've put into a PR to the repo this morning 👍

Done. Thanks to both.
For me, one of the things we need to improve is the where page (downloads).
I think we can take the design from the design made by Mark

In D53910#1290446, @carlavilla wrote:

In D53910#1290445, @cperciva wrote:

@carlavilla Can you try to get your changes merged so this can get committed soon? The 15.1 release cycle is about to get underway and I'm worried about this landing at a time when I'm doing a bunch of commits, especially since I stage them ahead of time and then push out when announcements are ready to go -- I don't want to have rebase problems show up at the wrong moment.

In my repo, I have the "main" page finished.
I'll try to have the rest today and send an email to core@ and doceng@

Hola @carlavilla — @grahamperrin pinged me some helpful proofreading bits late last night, which I've put into a PR to the repo this morning 👍

In D53910#1290952, @carlavilla wrote:

In D53910#1290819, @mark_freebsdfoundation.org wrote:

In D53910#1290817, @carlavilla wrote:

This is the problem; everywhere this is used for images absLangURL ($.Site.BaseURL) we should use {{ "link/to/file" | relURL }}.

Let me sort them out and issue PRs @carlavilla 😄

YEs, about this you are right, sorry for that :(

No apology necessary my good man! It's a complicated site and it's easy to miss 😊

Here you go, this should sort these few images… https://github.com/sergio-carlavilla/freebsd-new-design/pull/12

Everything merged

In D53910#1290817, @carlavilla wrote:

This is the problem; everywhere this is used for images absLangURL ($.Site.BaseURL) we should use {{ "link/to/file" | relURL }}.

Let me sort them out and issue PRs @carlavilla 😄

YEs, about this you are right, sorry for that :(

In D53910#1290802, @mark_freebsdfoundation.org wrote:

Thanks for merging the PRs @carlavilla . The reason the staging server is "missing" some images is because the code is using full URLs, which we shouldn't be doing…

{F152372940}

I'll take a look and issue a PR 👍

Thanks for merging the PRs @carlavilla . The reason the staging server is "missing" some images is because the code is using full URLs, which we shouldn't be doing…

In D53910#1290766, @mark_freebsdfoundation.org wrote:

In D53910#1290763, @carlavilla wrote:

view-source:https://freebsd.fortasse.cloud/

And for some reason some images are not there, and the same for some texts. Take a look to the footer

Oh yes, I see what you mean! Gruesome. That, I am thinking, is down to the way variables and Hugo code are used in templates. {{- -}} cuts spurious whitespace, {{ }} does not. If we're iterating over things in loops, there's a good chance Hugo is putting lots of whitespace in. Let me take a look at the template… 👀

EDIT OK, I'm sure this is the looping in the partials like _partials/news.html. All the variables are in {{ }} versus {{- -}} syntax. I'll need to take a good look at these …

In D53910#1290763, @carlavilla wrote:

view-source:https://freebsd.fortasse.cloud/

And for some reason some images are not there, and the same for some texts. Take a look to the footer

In D53910#1290762, @fernape wrote:

@fernape do you know what version of Hugo is on the CI server?

According to https://ci.freebsd.org/job/FreeBSD-doc-main/4513/consoleFull it was gohugo: 0.154.5_3,1

@carlavilla I've just noticed that website/data/releases.toml contains full URLs, which really, it shouldn't. Because it breaks testing on a different domain — the links will go back to the live site, not the test site. So things like all these data points should be relative URLs, without the server portion:

In D53910#1290735, @carlavilla wrote:

WARN  deprecated: .Site.Data was deprecated in Hugo v0.156.0 and will be removed in a future release. Use hugo.Data instead.
WARN  deprecated: .Site.Sites and .Page.Sites was deprecated in Hugo v0.156.0 and will be removed in a future release. Use hugo.Sites instead.

I'm really happy to see this moving again! Let's get it deployed soon, so the world stops thinking we're a dying project. We're anything but 👏

Yes, about the warning I know, fernape@ fixed it but for some reason he reverted the change.

I just took a look and for some reason, some strings are not translated, don't know why, and the same for some icons.
Also, can you deploy the minified version?

In D53910#1290526, @bz wrote:

I just looked at the staging site. My initial comment was: that's the next level of losing links to what is available on www.freebsd.org in information and this time we are avoiding the fact that monitors are WIDE and not 4:3 anymore for 1.5 decades. 70% of the landing page is white space and if you look at the generated page we are serving blank lines of HTML and little content in vertical scrolling. Please bring SGML back. *cry*

You need to update https://freebsd.fortasse.cloud/internal/about/ to which I have no idea to get to anymore if I wouldn't know /internal/ existed. Probably a fault of the previous (current) version already.

The sidebar on /security/ is unreadable with some items spanning 2-3 lines.

The footer uses more vertical space than content on some of the menu-accessible pages.

The 5 columns under the marketing which have information have become tiny unreadable here.

Firefox on a FreeBSD Laptop.

Looking peachy @carlavilla ! 👌 Could I push this version to the 'staging' server at https://freebsd.fortasse.cloud? It would be good for folks to view it there.

In D53910#1290355, @carlavilla wrote:

In D53910#1290350, @mark_freebsdfoundation.org wrote:

In D53910#1289152, @carlavilla wrote:

I saw the PR to my repo. I'll take a look this weekend.
The main page is finished.
We need to finish the others: events, news, 404, etc
And for sure, we cannot make the commit without core@ and doceng@ approval

We're good to go Sergio. This has been going on a long time with many discussions 😊 @dch just signed off on it.

We cannot go with the code as is now. At least, not with the code we have in this review. I made a lot of changes in the code I have in my repo.
Today I am updating the bsdinstall chapter, later I'll continue with this.

And I saw that @dch give the approval, but please, wait a bit. Take a look to the home.html, do you think we can commit this?
And there's a lot of copy&pasted functions from the documentation portal.

Right now, we cannot commit the code as is. When is ready in my repo I'll create a new diff or I'll put here. But wait a bit.

In D53910#1289152, @carlavilla wrote:

I saw the PR to my repo. I'll take a look this weekend.
The main page is finished.
We need to finish the others: events, news, 404, etc
And for sure, we cannot make the commit without core@ and doceng@ approval

Change home page to say 15.1 is upcoming

Fix all the Hugo data deprecation warnings

In D53910#1286399, @vladlen wrote:

In D53910#1284176, @carlavilla wrote:

The repository: https://github.com/sergio-carlavilla/freebsd-new-design

Hi Sergio!

I did pull request with fixed home page, that can work with all translation now https://github.com/sergio-carlavilla/freebsd-new-design/pull/9

Shortly:
6 features moved to adoc files in content/lang/home.
Downloads sections moved to _partials

Longer description:
The current home.html page already made significant progress toward better i18n support by adding variables for translating text on the home page.

My patch proposes to make i18n even easier and more consistent with other pages on the site, where all content is stored in .adoc files, while formatting and styles remain in the theme.

Changes made:

1. Feature sections moved to AsciiDoc files

I created the directories:

content/en/home
content/ru/home
content/zh-tw/home

Inside each, I created feature1.adoc through feature6.adoc for the six features on the home page. The full textual content has been moved into these .adoc files. The home.html template now only contains links to these files.

The content in these files is formatted naturally, the same way as the rest of the AsciiDoc content on the site.

The featureN.adoc files are explicitly listed in home.html to clearly define which files should be displayed on the home page. Additionally, each file includes a weight variable in its front matter to allow reordering of features.

2. "Downloads" and "Upcoming releases" sections moved to _partials/
3. Upcoming releases: I implemented i18n for this section. The correct link to schedule.adoc is now generated based on the language of the release documentation. The schedule URL is now available in English and Russian. The correct URL is automatically activated for non‑English languages based on variables defined in releases.adoc.

• Downloads: This section requires more work to achieve correct i18n. I plan to address it in a follow‑up step, provided this patch is accepted.

3. Legacy versions

The current site excludes "Legacy versions" from the design. However, the name "Legacy" sounds misleading — these are actually currently supported versions. In my opinion, they should also be listed on the downloads section. This could be addressed in a future patch.

P.S. Important: This patch moves the page content into .adoc files, but the visual appearance of the page remains exactly the same as it is now.

Rebase from main

@ziaee I know this has dropped OK, but just wanted to say, don't get rid of baseof.html! I'm fairly sure it is the root of the whole template for Hugo. https://gohugo.io/templates/new-templatesystem-overview/#example-folder-structure

Hello @carlavilla — is your working branch somewhere I can pull/rebase please? I'd love to get this all in place, and live, sometime soon — my original goal was last Christmas 😆

In D53910#1272513, @carlavilla wrote:

In D53910#1272506, @ziaee wrote:

Ping. Perhaps the patch could use rebasing.

Hola,
I am with it, I'm making a lot of changes.
Give me this week.

In D53910#1272513, @carlavilla wrote:

In D53910#1272506, @ziaee wrote:

Ping. Perhaps the patch could use rebasing.

Hola,
I am with it, I'm making a lot of changes.
Give me this week.

In D53910#1265008, @wosch wrote:

Just out of curiosity – is this scheduled to go live before or after the release of FreeBSD 14.4 (10 March 2026)?

In D53910#1265008, @wosch wrote:

Just out of curiosity – is this scheduled to go live before or after the release of FreeBSD 14.4 (10 March 2026)?

In D53910#1265017, @carlavilla wrote:

Mark, what happened with the old design? The main page is totally different.

And another question. Do you know the license of the images? I mean the logos. Can we use them without problems?

In D53910#1252298, @carlavilla wrote:

Give me a couple of days to review it

In D53910#1252043, @minsoochoo0122_proton.me wrote:

Thank you for your great work! I always wanted to investigate but it's good to hear that there has been ongoing effort on this.

Just based on the look (not looking at the source code) so I can be in POV of newcomers to our website, there are a few things I would like to point out.

1. In dark mode, the background is... too dark. Can we have the colour for the dark mode background of the documentation website?
2. The header is thick. It's because in the freebsd logo on top-left, the beastie logo is too huge compared to "FreeBSD". I don't know if this is a image protected by the foundation, but we can always ask if we're allowed to modify it.
3. On the front page, the FreeBSD logo is too huge. I would make it similar size to the font of "A Powerful, Open Source Operating System". Again, the beastie logo is too huge compared to "FreeBSD"
4. The latest news to press column boxes are too crowded (font is too huge) on my laptop (responsive css issue). It would be better if they were 2 rows where the first row has 3 columns and the second row has 2 columns.
5. Same for six sections under "Why FreeBSD?". Laptops need more space (padding, margin, etc).
6. On /releases, the image on top stands out too much on non-light mode. I think removing it would be better.
7. I'm not sure if this is a bug in hugo or in website code, but when I load /where, /release, and /releng, it loads the following look below then properly loads the theme (this happens in split second, but it's quite annoying).

Other than that, there are a few padding/margin/gap issues, but I don't know how to explain this. After this patch is merged, I can tweak css to find the best layout.

In D53910#1249075, @maxim wrote:

@vladlen @andy would you gentlemen please check it out? I'd love to hear our multi-lang support doesn't have any major issues after these changes.

site-footer: Fix broken link for security

In D53910#1248962, @rcocker87_gmail.com wrote:

Hello group!

Is the community Wiki part of this new theme revision

I noticed this contrast between the community Wikipedia page and this new theme revision https://wiki.freebsd.org/

At the bottom of the page

{F141925374}

Remove large bottom margin from hero section.

Validator fixes to header and footer

In D53910#1247618, @rob_belics.com wrote:

You probably already do this but occasionally run the HTML through the W3C HTML Validator for that list of errors and warnings: https://validator.w3.org/nu/
And then there's the CSS Validator: https://jigsaw.w3.org/css-validator/ A lot of those vendor extensions can be removed.

press.html: Fix broken press feed URLs

site-footer: those stray }} shouldn't be there

hugo.conf: remove unused params variable

Rebase. Remove .gitignore changes (not required)

In D53910#1246726, @rob_belics.com wrote:

Looking through the markup I see there are slashes placed at the end of self-closing tags such as <meta>, <link>, <img> and others (and sometimes not). But no HTML standard has ever specified that slashes be put there. This is a holdover from when people thought we'd all be using XHTML/XML for web pages. While allowed for that reason, putting a slash there has no meaning, it does nothing, is not required and browsers ignore it. If anything, the slash can cause problems for unquoted attributes. As a long time web developer, I suggest these be removed.

Fix void tags as per comment D53910#1246726

Remove unused Netflix logo image file

Remove a section: clutter. Fix pointer on menus.

Fix search box as per jrtc27 report. Fix community box copy.
Fix download links background colour.

In D53910#1245453, @grahamperrin wrote:

docs not invited to review, is the omission intentional?

https://reviews.freebsd.org/project/profile/72/

People who are willing to review documentation changes (opt-in)

I should add: in my experience, omissions are most often accidental :-)

(OT: Phabricator is complicated. Discovery, including discovery of things that have human members, is sometimes not easy. I look forward to use of Forgejo.)

In D53910#1241795, @adrian wrote:

hi!

The main bit of feedback I have is "please don't mix company stuff with project features." We have plenty of other large companies that contribute to freebsd; I think having a big netflix logo and only mentioning netflix in networking is doing everyone else a disservice.

I highly recommend finding a replacement image for networking, remove the Netflix mention and just mention "Many companies that power the Internet.." or something to that effect.

Thanks!

In D53910#1241780, @jrtc27 wrote:

Just looking at the homepage there is some very strange use of whitespace: specifically, there is a lot of extra vertical whitespace in various places that look unbalanced and make the content too spread out, and there is vertical whitespace lacking in the feed headings. See the attachments for before and after fixing these oddities that make the design feel more cohesive, polished and readable.

freebsd.fortasse.cloud.pdf267 KBDownload

jrtc27-freebsd.fortasse.cloud.pdf267 KBDownload

Fixes: copy in 'why' boxes, remove Netflix

Rebase to 5-Jan-26

In D53910#1243475, @ziaee wrote:

I've made some content and mechanical changes in my local branch, but when I make clean website; firefox website/public/index.html renders just broken black and white.