Bug 257404 - FreeBSD Handbook: list of links to additional resources for ZFS
Summary: FreeBSD Handbook: list of links to additional resources for ZFS
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks: handbook-2022
  Show dependency treegraph
 
Reported: 2021-07-25 08:47 UTC by Graham Perrin
Modified: 2022-05-03 20:22 UTC (History)
2 users (show)

See Also:


Attachments
A screenshot of Oracle's page (61.77 KB, image/png)
2021-07-25 08:48 UTC, Graham Perrin
no flags Details
open-zfs to openzfs url; removed Oracle link in Further Reading (4.06 KB, patch)
2022-04-19 15:27 UTC, John Darrah
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2021-07-25 08:47:34 UTC
Two of the links under 
<https://docs.freebsd.org/en/books/handbook/zfs/#zfs-links> 


1) 

<http://open-zfs.org/> is outdated. Instead: 
<https://openzfs.org/>

2) 

<http://docs.oracle.com/cd/E19253-01/819-5461/index.html> no longer appears as it should; <https://discord.com/channels/727023752348434432/760416197803245591/868506932539965530> – given the FreeBSD focus on OpenZFS, I reckon that it's safe to discard the link to Oracle's documentation.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2021-07-25 08:48:07 UTC
Created attachment 226673 [details]
A screenshot of Oracle's page

Firefox 90.0.1, safe mode.
Comment 2 John Darrah 2022-04-19 15:27:23 UTC
Created attachment 233336 [details]
open-zfs to openzfs url; removed Oracle link in Further Reading
Comment 3 Pau Amma 2022-04-22 04:49:46 UTC
Comment on attachment 233336 [details]
open-zfs to openzfs url; removed Oracle link in Further Reading

>diff --git a/documentation/content/en/books/handbook/bsdinstall/_index.adoc b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
>index 625462331d..f06cb706ca 100644
>--- a/documentation/content/en/books/handbook/bsdinstall/_index.adoc
>+++ b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
>@@ -132,6 +132,7 @@ A 32-bit kernel can only use the first 2 GB of RAM.
> == Pre-Installation Tasks
> 
> Once it has been determined that the system meets the minimum hardware requirements for installing FreeBSD, the installation file should be downloaded and the installation media prepared.
>+An alternative is to use virtualization (crossref:virtualization[virtualization,Virtualization]) which allows multiple operating systems to run at the same time without modifying any disk partitions.

Unrelated.

>@@ -169,7 +170,7 @@ Since the possibility of selecting the wrong partition exists, always backup any
> ====
> +
> Disk partitions containing different operating systems make it possible to install multiple operating systems on one computer.
>-An alternative is to use virtualization (crossref:virtualization[virtualization,Virtualization]) which allows multiple operating systems to run at the same time without modifying any disk partitions.
>+Virtualization (crossref:virtualization[virtualization,Virtualization]) allows multiple operating systems to run at the same time without modifying any disk partitions.

Unrelated.

>diff --git a/documentation/content/en/books/handbook/zfs/_index.adoc b/documentation/content/en/books/handbook/zfs/_index.adoc
>index 3f9a2a457d..a468eabb7f 100644
>--- a/documentation/content/en/books/handbook/zfs/_index.adoc
>+++ b/documentation/content/en/books/handbook/zfs/_index.adoc

>-Creating a ZFS storage pool (_zpool_) requires permanent decisions, as the pool structure cannot change after creation.
>+Creating a ZFS storage pool requires permanent decisions, as the pool structure cannot change after creation.

Unrelated

>@@ -580,7 +580,7 @@ This can cause undefined behavior in applications which had open files on those
> [[zfs-zpool-attach]]
> === Adding and Removing Devices
> 
>-Two ways exist for adding disks to a zpool: attaching a disk to an existing vdev with `zpool attach`, or adding vdevs to the pool with `zpool add`.
>+Two ways exist for adding disks to a pool: attaching a disk to an existing vdev with `zpool attach`, or adding vdevs to the pool with `zpool add`.

Unrelated.
Comment 4 commit-hook freebsd_committer freebsd_triage 2022-05-03 20:18:10 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=712ef570f8656bbdfe557f1e71f894d28d131b70

commit 712ef570f8656bbdfe557f1e71f894d28d131b70
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2022-05-03 20:15:56 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2022-05-03 20:15:56 +0000

    Upgrade ZFS links in Handbook

    * Upgrade OpenZFS link
    * Remove old Oracle ZFS link

    PR:             257404
    Submitted by:   Graham Perrin <grahamperrin (AT) gmail.com>

 documentation/content/en/books/handbook/zfs/_index.adoc | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)
Comment 5 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2022-05-03 20:22:26 UTC
Fixed. Thanks!