[Handbook WG] - Rework the filesystems chapter
ClosedPublic
Actions

Authored by carlavilla on Thu, Jan 9, 6:18 PM.

Details

Reviewers

Group Reviewers

Doc Committers
docs

Commits

Summary

As part of the 5th revision of the handbook, rework the filesystems chapter

Changes:

Bugs will fix: 254191

Repository

R9 FreeBSD doc repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

carlavilla requested review of this revision.Thu, Jan 9, 6:18 PM

carlavilla created this revision.

documentation/content/en/books/handbook/filesystems/_index.adoc
112	Should this and the previous sentences be connected via comma rather than dot?

Looks good to me, thanks!

This revision is now accepted and ready to land.Sun, Jan 12, 2:59 PM

documentation/content/en/books/handbook/filesystems/_index.adoc
112	I think so. How about this? The FAT file system is a simple and robust file system. Although it lacks the performance, reliability, and scalability of modern alternatives, its availability on many different operating systems makes it a common choice for data exchange between devices.

documentation/content/en/books/handbook/filesystems/_index.adoc
95	Shouldn't paths be in [.filename] tags?
110	FAT (for consistency when we talk about exFAT and we don't use "the").
115	Same doubt about paths.
128	path is wrong for package. I can't find it in my ports collection...
162	Not sure about the registered character. We use "(R)" in other parts of the documentation.
165	fuse-ntfs broken link.
207	fusefs-hfsfuse broken link.
231	Same for the paths.

Thanks for all the comments, I'm gonna fix everything right now.

ziaee added inline comments.

documentation/content/en/books/handbook/filesystems/_index.adoc
112	I think that's a "run on sentence" if you merge them, hampers accessibility. This is amazing! Very good chapter. Big thanks to Sergio for seeing a good example for me. If there's anything to add, I'd like to mention that this is known for being the efi filesystem, and the embedded device filesystem. However, I think it's important to consider Sergio's use of a terse and accessible, to the point style here. Sorry I forgot to submit this earlier!

carlavilla marked 11 inline comments as done.Sun, Jan 12, 8:08 PM

carlavilla added inline comments.

documentation/content/en/books/handbook/filesystems/_index.adoc
128	Really good catch! I think this was related to the last changes in the Ports tree

carlavilla marked an inline comment as done.

This revision now requires review to proceed.Sun, Jan 12, 8:08 PM

This revision is now accepted and ready to land.Tue, Jan 14, 5:23 PM

Sorry, I forgot about moving filesystem manpages for freebsd 15!

documentation/content/en/books/handbook/filesystems/_index.adoc
87	I don't know the timeline for publishing but ext2fs is moved to section 4 in FreeBSD 15
136	I don't know when this is intended to be published but I moved kernel modules for filesystems to section 4 with the other kernel modules in FreeBSD 15.
173	Ditto
215	Ditto