Wordsmith the docs project website title heading to make it clearer
that this is the docs project portal and not the main website home.
Also, tighten redundant uses of "FreeBSD". Saying it at least once
in every line and heading is quite tedious. Similarily, give the
anchors a more accurate and unique name to ease contribution.
Also tidy grammar on the search bar. Search bars never get punctuation,
unless it's an elipsis, the project uses serial commas, and "in" is not
really correct here.
The historical docs archive has a tile on docs.freebsd.org,
it does not need to be in the footer, which is wildly unbalanced.
Reviewed by: wosch
Event: Berlin Hackathon 202609
Make "Licensing" link in the footer go to the actual licensing page.
The legal column of the footer had two links, "legal notices" which went
to the licensing page. "licensing" which went to the first link therein.
Reported by: wosch
Reviewed by: michaelo, wosch
Event: Berlin Hackathon 202609
Downloads is misplaced here. This is the site for the docs project,
and downloads is in the global header anyway. Take that out, and put
the historical docs archive at the bottom.
Event: Berlin Hackathon 202609
Reviewed by: carlavilla, wosch
Differential Revision: https://reviews.freebsd.org/D59447
The website previously contained metadata to format links on Twitter.
This incorrectly tags everything on the site as docs.freebsd.org, and
is attempting to cater to a closed platform that is not related to us.
Discussed with: bofh, wosch
Event: Berlin Hackathon 202609
From 1995-2021, the project website said "1995-???? The FreeBSD Project"
until the rewrite to hugo/asciidoctor, when it became erroneously listed
as 1995-2020 The FreeBSD Foundation. The Foundation owns the trademarks,
not the copyright, and they can not own a copyright before they existed.
Reported by: wosch
Reviewed by: wosch
Event: Berlin Hackathon 202609
Fixes: 989d921f5d ("Migrate doc to Hugo/AsciiDoctor")
Mailto is an important page, one of the many that was lost in the reorg.
Revive it as freebsd.org/contact, and move it to the legal column in the
footer. The bottom heading of mailto used to be commercial vendors, zap
that and replace it with a legal section for the freebsd foundation.
Also simplify some of the language a bit.
Adding core as a *non-blocking* reviewer so they can weigh in if they
desire, but I think this is extremely positive and reasonable and we can
keep iterating, so I do not intend to wait for them unless they ask.
Event: Berlin Hackathon 202609
Reviewed by: wosch
Suggested by: wosch
Differential Revision: https://reviews.freebsd.org/D59442
header: move ports to Get FreeBSD
footer: add ports, remove 44bsd docs archive. It is still in docs/
where/: remove ports, and remove it from the sidemenu
Event: Berlin Hackathon 202609
Reviewed by: wosch
Suggested by: wosch, michaelo
Differential Revision: https://reviews.freebsd.org/D59442
This follows changes made to the source tree to mdoc(7) and example(4).
All of our documentation on driver SYNOPSIS is now consistent.
Discussed with: arch@ (marc.info/?l=freebsd-arch&m=176782215606871)
This will reduce maintenance burden going forward, also it serves to
demonstrate that we can trivially implement redirects in the tree vs
doing other things that are more labor intensive.
Differential Revision: https://reviews.freebsd.org/D57792
Chromium has available search engines region locked for compliance
reasons. Note that in order to have available search engines, like
duckduckgo, chrome requires a specific locale to be set.
Differential Revision: https://reviews.freebsd.org/D57142
Asciidoctor documentation says sectnumlevels from 0-5 are accepted.
Since every chapter sets this value to 6, it is not being parsed and
does not do anything.
Reviewed by: aokblast
Fixes: bdf18a0458 ("handbook: Remove sectnumlevels")
Differential Revision: https://reviews.freebsd.org/D57646
Convert our custom macros to output asciidoctor instead of raw html,
silencing 6500 warnings. This will enable us to turn verbose builds
on, which will enable us to actually understand what is going on in
the doc tree.
Reviewed by: dch, kevans
Asciidoctor documentation says sectnumlevels from 0-5 are accepted.
Since every chapter sets this value to 6, it is not being parsed and
does not do anything.
Discussed with: bcr
The installation note does not contain installation instructions, and
has not since FreeBSD 6.0. Rename it to the upgrading note to avoid
confusion with the installation guide. Consolidate all release upgrading
information here.
Rewrite the introduction to the release note to separate these out more.
Remove information that is not needed to introduce this release.
The release installation notes do not actually contain instructions on
installing FreeBSD, so rename it to the Upgrading Note.
Reviewed by: carlavilla (previous), cperciva
Discussed with: cperciva, dch, emaste, fuz, michaelo
Co-authored-by: Vladlen Popolitov <vladlen@FreeBSD.org>
Differential Revision: https://reviews.freebsd.org/D57517
Unconditionally send the website footer link to the contributing article
to the english version, as a stopgap to fix the 404. This link needs to
preserve the language.
Reported by: debg
Reviewed by: carlavilla
Differential Revision: https://reviews.freebsd.org/D57064
This page is really long, and has no introductory paragraph.
Instead of hiding the installation section at the bottom, simplify
it into an introductory paragraph.
Reviewed by: cperciva
Differential Revision: https://reviews.freebsd.org/D56956
FreeBSD hasn't fit on a CD-ROM in a long time,
and nobody we know of is selling FreeBSD DVDs.
This whole page needs TLC, one thing at a time.
Reviewed by: carlavilla
Discussed with: cperciva, mchoo
Differential Revision: https://reviews.freebsd.org/D56981
The last few years, there is only one distributor of FreeBSD discs,
and they only update their website if I send them an email, so I think
they are not actually selling any and nobody wants this.
Discussed with: cperciva
This page is about where to get FreeBSD as released by the Project.
This list also exists in the handbook, and doesn't really belong here.
Reviewed by: adrian, emaste
Differential Revision: https://reviews.freebsd.org/D56955
There are a few places where we compare a RELEASE to it's STABLE branch,
or a RELEASE to it's previous release. Use macros so we can bump these
instead of bumping the numbers constantly.
Outstanding:
- I don't know what to do with rel-latest-previous since we're at a .0
currently, it should be whatever the reader should update to before they
update to 15.0. The jails chapter would benefit greatly from that.
- The syntax for escaping to use a macro inside of a code block is
still I can't figure it out... but other than that it's working well!
Fixes: ff71b333bf (releases: define rel-latest macro)
Reviewed by: mhorne
Suggested by: Jan Brankamp <crest@rlwinm.de>
Differential Revision: https://reviews.freebsd.org/D56104
The website has really complex deprecated hugo logic for localization.
To simplify this and eliminate linter warnings, we first need a modern
hugo language key. Build that in hugo.toml, and remove all the extra
files related to the old way of doing this. This removes several INFO
messages about deprecated syntax during the build, increases clarity
of the build system, and allows us to begin transitioning off the
remaining deprecated elements.
Reviewed by: carlavilla
Differential Revision: https://reviews.freebsd.org/D56173
The FreeBSD shell is a POSIX compatible shell. It evolved over several
decades from the Almquist shell, which was preceeded a decade before
that by the Bourne shell. Most readers today have never seen a Bourne
shell. If someone wants to learn to use our shell, they need to look for
tutorials on the POSIX shell. Align descriptions through out the tree
with this reality, consistent with it's manual and common parlance.
Reviewed by: mhorne, Artem Bunichev <tembun@bk.ru>
Differential Revision: https://reviews.freebsd.org/D56054
- builtin(1) rewrite with keybinds(1) appeared
- newaliases(1) manpage update moved to manpages
- vt(4) learned about increasing console scrollback size
- most ethernet switch manuals appeared or were improved
- dumpon(8) learned about settings for crash dumps
The Windows dev kit 2023 has been working since 13.2 or 13.3. Add it to
the list of working arm platforms in the hardware release note template
as well as currently supported releases.
Reported by: fuz
+ Move Ports Security Team after Security Team
+ Primary Release Engineering is now Release Engineering
+ Move Release Engineering into Teams before Security team
Discussed with: cperciva
List three known traps upgrading to 15.0R in the release errata.
Noting: this is 34 days late, but first time since 12.0R
Discussed with: adrian, imp, jhb, jrtc27, ngie
Reviewed by: adrian
I just discovered this driver while auditing apropos results. Turns out,
this driver has existed since FreeBSD 11.0. It was not built by default
initially, but the module is present on my 15.0-RELEASE box.
Add a macro defining the latest current RELEASE that people should use
for new deployments. This will improve consistency and save time bumping
version numbers in handbook examples, which has been suprisingly error
prone.
Jan Brankamp on the Production Users Call suggested we also define a
rel-previous macro. I do not need that yet, but note it here to inspire
future discussion.
Approved by: dch (re)
Differential Revision: https://reviews.freebsd.org/D54293
Judging from the mailing list discussion, this section needs organized
better. While here, sneak in a bit of wordsmithing. We still have a lot
of work to do improving the instructions for upgrading systems installed
with packages, but we have to keep moving.
Discussed with: cperciva (it's still ok to organize better)
Discussed with: ivy (s/distribution/& sets/)
Discussed with: jrm (upgrading from source wordsmithing)
Reviewed by: dch (previous, fixed a typo since)
Differential Revision: https://reviews.freebsd.org/D54181
I tried running plasma wayland on 15.0, it works great! CPU usage
is a tad high, but I'm impressed! Freshen the branding and language
in this chapter to highlight this. Remove a stale note about adjusting
message sizes to what is now the default. Tell the reader how to search
the kde-applications category. Add instructions to launch with wayland.
Reviewed by: carlavilla (previous), makc
Differential Revision: https://reviews.freebsd.org/D54207
Alexander Ziaee