02/03: website: gnu-guix-1.4.0-released: Tweak SWH/Disarchive bits.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix-artwork.

commit 745a664a28c71a09ebbefeb08104665827d1fbeb
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Sun Dec 18 18:10:53 2022 +0100

    website: gnu-guix-1.4.0-released: Tweak SWH/Disarchive bits.
    
    * website/drafts/gnu-guix-1.4.0-released.md: Tweak SWH/Disarchive bits.
---
 website/drafts/gnu-guix-1.4.0-released.md | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/website/drafts/gnu-guix-1.4.0-released.md 
b/website/drafts/gnu-guix-1.4.0-released.md
index af6911a..3fafde7 100644
--- a/website/drafts/gnu-guix-1.4.0-released.md
+++ b/website/drafts/gnu-guix-1.4.0-released.md
@@ -148,8 +148,6 @@ Software Heritage as a fallback, with version 1.4.0 **the 
source code of
 Guix channels is automatically fetched from Software Heritage** if its
 original URL has become unreachable.
 
-![Diagram showing Disarchive and Software 
Heritage.](/static/blog/img/disarchive-swh-diagram.png)
-
 In addition, Guix is now **able to retrieve and restore source code
 tarballs** such as `tar.gz` files.  Software Heritage archives the
 _contents_ of tarballs, but not tarball themselves.  This created an
@@ -158,11 +156,14 @@ 
definitions](https://guix.gnu.org/manual/en/html_node/Defining-Packages.html)
 refer to tarballs and expect to be able to verify the content hash _of
 the tarball itself_.  To bridge this gap, Timothy Sample developed
 [Disarchive](https://ngyro.com/software/disarchive.html), a tool that
-can (1) _extract_ tarball metadata, and (2) _reconstruct_ a tarball from
-its previously-extracted metadata and the actual files.
+can (1) _extract_ tarball metadata, and (2) _assemble_
+previously-extracted metadata and actual files to reconstruct a tarball,
+as shown in the diagram below.
+
+![Diagram showing Disarchive and Software 
Heritage.](/static/blog/img/disarchive-swh-diagram.png)
 
 The Guix project has set up a [continuous
-integration](https://ci.guix.gnu.org/jobset/disarchive) job to build a
+integration job](https://ci.guix.gnu.org/jobset/disarchive) to build a
 _Disarchive database_, which is available at
 [disarchive.gnu.org](https://disarchive.guix.gnu.org).  The database
 includes metadata for all the tarballs packages refer to.  When a source
@@ -172,6 +173,8 @@ Heritage, and reconstructs the original tarball.  As of the
 “[Preservation of Guix Report](https://ngyro.com/pog-reports/latest/)”
 published in January 2022, almost 75% of the `.tar.gz` files packages
 refer to are now fully archived with Disarchive and Software Heritage.
+Running `guix lint -c archival PKG` will tell you about the archival
+status of `PKG`.
 You can read more in the [annual report of
 Guix-HPC](https://hpc.guix.info/blog/2022/02/guix-hpc-activity-report-2021/).