aboutsummaryrefslogtreecommitdiff
path: root/documentation
Commit message (Collapse)AuthorAgeFilesLines
* pgpkeys: add my @f.o uid to my new key, as wellHEADmainKyle Evans2026-07-241-6/+11
| | | | Fixes: bd5cfe18aceb ("pgpkeys: include second key for kevans")
* pgpkeys: update the keys for core@Kyle Evans2026-07-241-11/+11
| | | | | | | | adrian@ omitted at the moment until he publishes a new key, soon. Approved by: core Reviewed by: adrian Differential Revision: https://reviews.freebsd.org/D58430
* pgpkeys: include second key for kevansKyle Evans2026-07-231-3/+22
| | | | | This is cross-signed by my original key, and I accidentally used it to sign an announcement.
* pgpkeys: Update dsl@ keyDmitry Salychev2026-07-211-67/+17
|
* Handbook - ZFS: how to mount encrypted zpool with geliSergio Carlavilla Delgado2026-07-181-0/+18
| | | | PR: 240421
* Handbook - ZFS: ReworkSergio Carlavilla Delgado2026-07-181-517/+1673
| | | | | | | | | | | | | | | | | * Add RAID-Z expansion, dRAID, special vdevs, hot spares with zfsd, TRIM, pool checkpoints, block cloning, fast dedup, bookmarks, holds, resumable/corrective send, project quotas, direct I/O, and boot environments * Add Jails and ZFS crossref target, encryption key loading at boot (zfskeys), and a Pool Properties section * Rewrite Tuning to drop removed sysctls (scrub_delay, vdev.cache.size, arc.meta_limit, …); delete the obsolete ZFS-on-i386 section * Switch examples to ada device names and GPT partitions * Fix the inverted reservation terminology entry, zfs scrub: zpool scrub, stale checksum/compression algorithm lists, and EOL version framing Approved by: arrowd@, bcr@, michaelo@ Differential Revision: D58175 PR: 287148, 261212, 263321
* Harmonize the cross repo advice.Warner Losh2026-07-141-5/+22
| | | | | | | | | | | The other committer's guide was written years before the cross repo commit bit stuff. Harmonize and expand a little the advice given to make it also match the tone of the new policy and our usual practices being a little more relaxed than what was documented previously. Sponsored by: Netflix Feedback by: jhb Differential Revision: https://reviews.freebsd.org/D58007
* Handbook - Jails: Upgrade chapterSergio Carlavilla Delgado2026-07-121-68/+1232
| | | | | | | | | | * Improve top-level sections * Add NAT/port forwarding, administration from inside a jail, more jail options and jails with OpenZFS * Improve host network preparation, jail.conf and userland sources Approved by: arrowd@, bcr@ Differential Revision: D58173
* Handbook - wine: Fix packages pathsDudley Innocent2026-07-121-3/+3
| | | | | PR: 296708 Differential Revision: D58166
* committers-guide: Use macros for branch examplesAlexander Ziaee2026-07-121-19/+19
| | | | | | PR: 279503 Reviewed by: wosch Differential Revision: https://reviews.freebsd.org/D57937
* containers: Add OCI setup and usageDave Cottlehuber2026-07-111-0/+865
| | | | | | | | | Reviewed by: adrian Reviewed by: bcr Reviewed by: dfr Approved by: ziaee Sponsored by: SkunkWerks, GbmH Differential Revision: https://reviews.freebsd.org/D57862
* [phb][Uses]: Add npmFernando Apesteguía2026-07-101-0/+36
| | | | | Following https://cgit.freebsd.org/ports/commit/?id=ed6a84c1c9793271c9cf948458808b47b2622d21
* Revert "Update porter handbook: Quarterly and Latest Ports Branches"Rodrigo Osorio2026-07-101-2/+2
| | | | This reverts commit cdd42f11b285d8886b774a2659f92359c5304a88.
* Update porter handbook: Quarterly and Latest Ports BranchesRodrigo Osorio2026-07-101-2/+2
| | | | | | | | Summary: By default, the pkg ports repo is now "FreeBSD-ports". Reviewers: bcr Differential Revision: https://reviews.freebsd.org/D54574
* [phb][Uses]: Remove azurepyFernando Apesteguía2026-07-091-8/+0
|
* documentation: fix crossref macro with comma in parameterVladlen Popolitov2026-07-079-20/+32
| | | | | Approved by: carlavilla, ziaee Differential Revision: https://reviews.freebsd.org/D58046
* books/dev-model: change bibliography linksVladlen Popolitov2026-07-051-33/+31
| | | | | Approved by: carlavilla Differential Revision: https://reviews.freebsd.org/D58045
* handbook/zfs: Add new section about ZFS native encryptionBenedict Reuschling2026-07-051-0/+299
| | | | | | | | | | | | | | This change adds a new section describing how to use ZFS native encryption including examples to the handbook. It is based on my own training material, the open-zfs.org documentation on the subject and the corresponding man pages (zfs-load-key(8), zfs-unload-key(8)). I ran my writeup through an AI for grammar, typo and active voice fixes, instructing it to not make any changes to the text itself. PR: 264531 Reviewed by: michaelo@ Event: Halifax Hackathon 202606 Differential Revision: https://reviews.freebsd.org/D57889
* Commit bit out of safekeeping (ports): Martin Cracauer (cracauer)Martin Cracauer2026-07-032-0/+60
| | | | | | | | | | | Completed steps 1-4 from Committer's Guide. Approved-by: jbo (mentor), doceng (implicit) Differential Revision: https://reviews.freebsd.org/D57933 Reviewed by: jbo Differential Revision: https://reviews.freebsd.org/D57933
* documentation: fix WARN after hugo setings changeVladlen Popolitov2026-07-0225-332/+332
| | | | | | Reviewed by: carlavilla, ziaee Approved by: carlavilla Differential Revision: https://reviews.freebsd.org/D57999
* books/fdp-primer: remove duplicate sentencesAlexey Shuvaev2026-07-012-6/+3
| | | | PR: 295678
* handbook/bsdinstall: Fix example block attributesAlexander Ziaee2026-06-291-2/+2
| | | | | | This allows the example block to always show the latest release. Fixes: a2f2b294050c ("handbook/bsdinstall: Use latest release macro")
* fdp-primer: Remove duplicate sentence from FreeBSD Quickstart instructionsBenedict Reuschling2026-06-281-3/+0
| | | | | The sentence was extended in a previous commit, but this fragment remained and only appeared in this section.
* handbook/multimedia: Move explanation of abbreviation to first time it appearsBenedict Reuschling2026-06-281-5/+5
| | | | | | | | | | The abbreviation of DI is used before before it is explained later. Move the later to the first use instead. While here, fix some whitespace after the sentence stop. Event: Halifax Hackathon 202606 Location: Lounge
* Handbook-multimedia: Adding resampling audioMarcel Weissenbach2026-06-281-0/+31
|
* FDP-Overview: Update Debian installation instructionsMarcel Weissenbach2026-06-281-1/+1
|
* Handbook-multimedia: Replace moc and mplayerMarcel Weissenbach2026-06-281-16/+62
|
* Revert "fdp-primer: Mention that .po files are generated nightly"Benedict Reuschling2026-06-271-4/+1
| | | | | | This reverts commit 64b3126c0db9dcc8cf9a2f003b3a52dbb76a7fd1. It turns out the information was wrong and the PO files are not created nightly.
* porters-handbook: Use full-length hashes in GH_TAGNAMEEd Maste2026-06-271-2/+2
| | | | | | | | | | | | | Full hashes avoid possible conflicts, at the cost of a small increase in some path names. About 1/3 of the existing GH_TAGNAMEs in the ports tree are already full 40-character hashes. Reviewed by: bcr Event: Halifax Hackathon 202606 Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D57901
* porters-handbook: Freshen up example datesEd Maste2026-06-271-5/+5
| | | | | | | | | Avoid looking like this document is over a decade old. Reviewed by: jrm, bcr Event: Halifax Hackathon 202606 Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D57900
* handbook/disks: Update encrypted swap instructions for geliBenedict Reuschling2026-06-271-2/+9
| | | | | | | | | | | | | Add instructions to initialize the geli swap device first. Also, be a bit clearer on the /etc/fstab line to add for geli. While here: fix a typo in the Camellia-CBC algorithm. PR: 282806 Reviewed by: carlavilla@ Event: Halifax Hackathon 202606 Location: Dalhousie CS Faculty building entrance hallway Differential Revision: https://reviews.freebsd.org/D57904
* fdp-primer: Add context instructions to two other locations and fix formattingBenedict Reuschling2026-06-261-3/+8
| | | | | | | | | | | | 7dcf0bd6337554f7a57ca1fe4d1ef79a269a0a23 only changed the instructions on how to add context to 'git format-patch' for Linux, leaving out the FreeBSD and macOS sections. Add the same instructions there, too. Additionally, I fixed the formatting of the enumerations I broke in the commit mentioned above. Event: Halifax Hackathon 202606 Location: Lying on the couch
* fdp-primer: Mention that .po files are generated nightlyAlexey Shuvaev2026-06-261-1/+4
| | | | | | | | | | There is no need to generate the .po files manually as they are generated every night. Describe this fact in the PO translations chapter. PR: 295901 Event: Halifax Hackathon 202606 Location: Back in my old chair
* fdp-primer: Include context in the git format-patch for users to useBenedict Reuschling2026-06-261-2/+4
| | | | | | | | | | | The quick start section did not instruct the reader to include context in the git format-patch example. This is not ideal as it makes reviewing easier. Include this information with a bit of explanation below it. Event: Halifax Hackathon 202606 Location: A different chair than obiwac's Reviewed by: lwhsu Differential Revision: https://reviews.freebsd.org/D57891
* Revert "handbook/zfs: Add new section about ZFS native encryption"Benedict Reuschling2026-06-261-299/+0
| | | | | This reverts commit 9ddc2f8625bf8d59738c10c1370ba03eac0677af. Not approved yet.
* fdp-primer: Include context in the git format-patch for users to useBenedict Reuschling2026-06-261-2/+4
| | | | | | | | | | | The quick start section did not instruct the reader to include context in the git format-patch example. This is not ideal as it makes reviewing easier. Include this information with a bit of explanation below it. Event: Halifax Hackathon 202606 Location: A different chair than obiwac's Reviewed by: lwhsu Differential Revision: https://reviews.freebsd.org/D57891
* handbook/zfs: Add new section about ZFS native encryptionBenedict Reuschling2026-06-261-0/+299
| | | | | | | | | | | | This change adds a new section describing how to use ZFS native encryption including examples to the handbook. It is based on my own training material, the open-zfs.org documentation on the subject and the corresponding man pages (zfs-load-key(8), zfs-unload-key(8)). I ran my writeup through an AI for grammar, typo and active voice fixes, instructing it to not make any changes to the text itself. Event: Halifax Hackathon 202606 Differential Revision: https://reviews.freebsd.org/D57889
* Move all the software license stuff to a central location.Warner Losh2026-06-263-28/+56
| | | | | | | | | | | | | | This leaves an appropriatesummary on the website pages, committer's guide and contributing pages, and augments license-guide with information that was on those pages (though the license exceptions moves to software-license). It's mostly word motion with light edits. Sponsored by: Netflix Reviewed by: ziaee, adrian Approved by: core (24 hour rule) Differential Revision: https://reviews.freebsd.org/D57340
* handbook/x11: Silence doc build warning by changing an example into ↵Benedict Reuschling2026-06-261-21/+21
| | | | | | | | programlisting While here, remove whitespaces from end of lines. No content changes. Event: Halifax Hackathon 202606
* handbook/jails: Small fixes to the Linux jail sectionAlfredo Cruz2026-06-231-3/+10
| | | | | | | | | | | | | | | | - Add missing containers/ path in one instance - Move the jail.conf creation to the beginning of this section (slightly modified from the original patch), because it fits better there instead of letting the reader know about it when starting the jail - Use sh as the shell executed when running jexec to ensure it is a jail that is present in Linux - Rephrase a sentence to avoid a comma and instead use "and" to connect the two packages to install (also modified from the original submission) Event: Halifax Hackathon 202606 PR: 295777 Differential Revision: https://reviews.freebsd.org/D57771
* Documentation: Remove manual pagesSergio Carlavilla Delgado2026-06-211634-348994/+0
| | | | | | The translated manual pages are totally outdated. Discussed with: doceng@
* handbook/virtualization: Fix copy&pasto in driver nameBenedict Reuschling2026-06-211-1/+1
| | | | | | | | The VMSVGA driver is the one that targets VMware guests, not VBoxSVGA. Before this fix, the sentence would contradict the one before it. I must have copied the wrong driver name when I made the original change. Noticed by: Takashi Shimizu
* pgpkeys: Add myself to the listColin Percival2026-06-211-0/+3
| | | | | | | | My pgp key has been in the repo for many years but apparently I wasn't listed in the pgpkeys article. PR: 296173 Reported by: elivoncoder
* handbook/containers: Avoid single sentence paragraphsBenedict Reuschling2026-06-201-14/+0
| | | | | | | Combine single sentence paragraphs together to form actual paragraphs. No content changes. Event: BSDCan 2026
* website/ru/releases fix wording in RussianVladlen Popolitov2026-06-202-9/+9
| | | | | Reviewed by: andy Differential Revision: https://reviews.freebsd.org/D57603
* handbook: Add containers chapterDave Cottlehuber2026-06-2021-36/+256
| | | | | | | Reviewed by: ziaee Event: BSDCan 2026 Sponsored by: SkunkWerks, GmbH Differential Revision: https://reviews.freebsd.org/D57654
* Teach hugo to listen over TLS without a port appendedDave Cottlehuber2026-06-201-0/+8
| | | | | | | | | | | | | Add targets to documentation & website, to serve the website over TLS, with nice clean URLs. You will need to provide the TLS terminating proxy yourself. Differential Revision: https://reviews.freebsd.org/D53930 Approved by: ziaee Reviewed by: kevans Event: BSDCan 2026 Sponsored by: SkunkWerks, GmbH
* handbook/virtualization: Add section on VBoxSVGA to make Xorg workBenedict Reuschling2026-06-201-1/+6
| | | | | | | | | | | | | | | When trying to run Xorg on FreeBSD as a VirtualBox guest, it fails to start the X server because of the wrong graphics driver. Instruct users to set the VBoxSVGA graphics adapter before installing the guest additions. Also, remove the "First," from the beginning of a later sentence, as there is no "Second", "Third", and so on and does not help much in this context. Event: BSDCan 2026 Reviewed by: ziaee@ Differential Revision: https://reviews.freebsd.org/D57693
* various: Fix links to PGP keyringDag-Erling Smørgrav2026-06-1825-26/+26
| | | | | | | Let the link text match the actual file name. PR: 295908 Fixes: adda9a606635 ("Link to the new pgpkeys.txt file in articles and books")
* pgpkeys: Fix dinoex's keyDag-Erling Smørgrav2026-06-181-0/+1
| | | | | | | | A missing blank line was causing a checksum error, preventing anyone from importing the keyring. PR: 295908 Fixes: c16a3df222e3 ("documentation/static/pgpkeys/dinoex.key: update gnupg key")