Commit Graph

224 Commits

Author SHA1 Message Date
Ludovic Courtès 7d4365e9df
doc: First stab at a "Secure Supply Chain" paper.
* doc/ccs-2021: New directory.
2022-01-10 08:50:38 +01:00
Mathieu Othacehe 969c0b5594
hydra: bayfront: Add Wireguard service.
* hydra/bayfront.scm: Add Wireguard service.
* doc/cuirass.org (External machines): Update it.
2021-12-21 15:55:40 +01:00
Mathieu Othacehe b6f0103c0a
doc: cuirass: Update machine list.
* doc/cuirass.org (External Machines): Update it.
2021-12-18 18:07:39 +01:00
Ludovic Courtès 91e17675d6
doc: sif-2021: Augment copyright notice.
* doc/sif-2021/article-1024.org (Copier cet article): Augment.
2021-11-26 10:29:03 +01:00
Ludovic Courtès 05f0227167
doc: sif-2021: Tweak wording.
* doc/sif-2021/article-1024.org: Tweak wording as suggested by Denis
Pallez.
2021-11-26 10:29:02 +01:00
Ludovic Courtès 223759e173
doc: Add article for "1024" (French).
* doc/sif-2021/article-1024.org: New file.
2021-11-26 10:29:02 +01:00
Thiago Jung Bauermann 4458abf9ec
Add guixp9 to the CI.
* doc/cuirass.org (External machines): Add guixp9.
* hydra/berlin.scm (services)[wireguard-service-type]: Likewise.
[frontend-services]<#:systems>: Add “powerpc64le-linux”.

Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
2021-08-28 15:06:25 +02:00
Maxim Cournoyer 96d7a21220
doc: Add detailed usage instructions for the announce-gen script.
And update the about.txt boilerplate text.

* doc/release.org (Update the on-line copy of the manual): Add a note
about restarting mcron after reconfiguring.
(Prepare the email announcement): Add usage instructions for
announce-gen.  Reword to explicit that appending NEWS should have been
handled by the announce-gen script.
2021-05-12 13:18:04 -04:00
Maxim Cournoyer 4e334119a3
doc: Update release instructions.
* doc/release.org (Bootstrap and build): Renamed from 'Bootstrapping'.
Use nproc * 2 as the parallel job count passed to make.
(Update the translation files): Renamed from 'Updating the translation
files'.  Suggest running 'autoreconf -f' after updating the
translations to catch mistakes and cross-reference the guix manual.
Drop last paragraph, which isn't that important anymore now that the
translations are fetched from git and not rate limited.
(Run “make release” for one or several release candidates): Simplify
wording.
(Merge the version-X-Y-Z branch into master): New section.
(Update web pages): Note mcron frequency.
(Prepare the email announcement): Use X.Y.Z version templates.
(Send the email announcement): Drop the newsgroups.  Publicly
available NNTP servers seem a rarity these days.
(Post a news item on the web site (automated)): Drop recommendations
about the form, as this is now all automated.
2021-05-11 23:38:33 -04:00
Maxim Cournoyer 29afac1fb6
doc: Update the gnupload command to include .qcow2 and .iso files (bis).
I had forgotten to update the command used for the release GNU FTP as
well.

* doc/release.org (Upload all the files) <gnupload>: Include the
.qcow2 and .iso release files.
2021-05-08 15:07:51 -04:00
Maxim Cournoyer eb5dcd9590
doc: Update the gnupload command to include .qcow2 and .iso files.
* doc/release.org (Upload all the files) <gnupload>: Include the
.qcow2 and .iso release files.
2021-05-08 14:56:07 -04:00
Maxim Cournoyer 829b73ab19
doc: Expound the note about the offload setup requirements.
* doc/release.org (Run “make release” for one or several release
candidates): Update the list of the required offload machine
architectures.  Mention that QEMU user (transparent) emulation is
likely not good enough.
2021-05-01 23:34:49 -04:00
Maxim Cournoyer 5e427babb6
doc: Add a note about using Gnulib's gnupload script.
* doc/release.org (Upload all the files): Mention where the script
originates and that it requires the ncftp package.  In the examples,
change directory to the release directory, as file names containing
slashes are rejected by the server.
2021-05-01 23:34:49 -04:00
Maxim Cournoyer eee6e52909
doc: Rename GuixSD to Guix System and remove redundant paragraphs.
* doc/release.org (Updating the translation files): Remove the
paragraphs detailing what do when starting from a pristine tree, as
this is what the 'Bootstrap' section now already covers.
(Run “make release” for one or several release candidates): Rename
GuixSD to Guix System.
2021-04-27 11:19:20 -04:00
Maxim Cournoyer 90f1a6c1cc
doc: Document that the project should initially be built.
This may be obvious in hindsight, but running 'make release' without
having run 'make' would lead to a confusing problem where the user's
guix command (a wrapper) would be used instead of scripts/guix,
leading to an erroneous GUILE_LOAD_PATH.

It would lead to using an older version of the guix package to build
the release artifacts.

* doc/release.org (Bootstrapping): Suggest running make.
2021-04-27 11:19:20 -04:00
Mathieu Othacehe 6e80806e00
doc: cuirass: Add information about NAT and keep-alive.
* doc/cuirass.org: Add information about NAT and keep-alive.
2021-04-22 09:54:15 +02:00
Maxim Cournoyer 8f27176037
doc: Briefly document how to add a new Cuirass jobset.
* doc/release.org (Add a Cuirass jobset for branch 'version-X.Y.Z'):
Expound section.
2021-04-20 17:36:23 -04:00
Maxim Cournoyer 42dc5e0d2c
doc: Add a caveat to the release section.
The 'release' target doesn't behave well when re-run after failing.
Document it as such.

* doc/release.org (Run “make release” for one or several release
candidates): Add caveat.
2021-04-20 17:36:23 -04:00
Maxim Cournoyer f182f52d18
doc: Update release.org.
* doc/release.org (Enter a guix environment containing everything
needed): New step.
(Add a Git tag): Reinstate the 'autoreconf -f' command.  It's needed
although 'make release' reruns autoreconf itself, as at that time the
PACKAGE_VERSION has already been inherited by the previous Makefile.
Stress that point in case the tag is recreated.
(Updating the translation files): Move the bootstrap invocation to the
new step added above.
(Run “make release” for one or several release candidates): Use Org
markup for file names and other literals.
2021-04-20 14:02:04 -04:00
Maxim Cournoyer 71a7ead100
hydra: Rename guix-x15.sjd.se and guix-x15b.sjd.se.
Simon mentioned the machines no longer have an associated A record;
rename name, for clarity.

* hydra/machines-for-berlin.scm (armv7)
<guix-x15.sjd.se, guix-x15b.sjd.se>:  Rename to guix-x15 and guix-x15b.
* hydra/berlin.scm (services) [wireguard]: Likewise.
* doc/cuirass.org (External machines): Likewise.
2021-04-20 11:26:20 -04:00
Mathieu Othacehe 74e7adf2fa
Add new Wireguard peers.
* doc/cuirass.org (External machines): Add guix-x15.sjd.se and
guix-x15b.sjd.se.
* hydra/berlin.scm: Add those new Wireguard peers.
2021-04-20 13:41:59 +02:00
Maxim Cournoyer f0a03e1211
doc: Add a note regarding new translation files.
* doc/release.org (Updating the translation files): Mention that new
translation files should be registered.

Suggested-by: Julien Lepiller <julien@lepiller.eu>
2021-04-18 16:10:56 -04:00
Maxim Cournoyer 007a94f593
doc: Document the process of updating the translation files.
In the context of preparing a new release.

* doc/release.org (Updating the translation files): New section.
2021-04-18 15:24:40 -04:00
Maxim Cournoyer 68ff163e2e
doc: Document some requirements of the update-NEWS target.
* doc/release.org (Update the list of new and updated packages):
Mention that some sections are expected to already exist.
2021-04-18 10:08:39 -04:00
Mathieu Othacehe 8d67909455
doc: Add cuirass.org.
* doc/cuirass.org: New file.
2021-04-15 10:19:19 +02:00
Ludovic Courtès 258220b06e
security-advisories: Expound.
* doc/security-advisories.org: Expound.
2021-04-02 23:19:12 +02:00
Mathieu Othacehe 396af4ccca
doc: Remove Cuirass how-to.
* doc/cuirass-howto.org: Remove it as all the described actions can now be
performed through the web interface.
2021-03-23 11:26:24 +01:00
Ludovic Courtès 1bc34954ec
doc: Add document on security advisories.
* doc/security-advisories.org: New file.
2021-02-10 12:46:16 +01:00
Ludovic Courtès 454bd26271
doc: Augment release document.
* doc/release.org (Run “make release” for one or several release
candidates): Add example to gpg-agent TTL.
(Add a Git tag): Pass '-f' to autoreconf.
2020-11-20 21:21:07 +01:00
Ludovic Courtès b7aa104508
doc: refcard: Update version, URL, and year.
* doc/refcard/guix-refcard.lout: Update version, URL, and copyright year.
2020-10-08 10:41:01 +02:00
Ludovic Courtès 2362e90474
doc: refcard: Fix syntax of '--with-branch' and '--with-commit'.
* doc/refcard/guix-refcard.lout: For --with-branch and --with-commit,
add "package=".
2020-10-08 10:37:29 +02:00
Gábor Boskovits 8ab9ca6197
doc: outreachy: Add doc on how to submit a proposal.
* doc/outreachy/submitting-a-proposal.org
2020-09-19 16:17:37 +02:00
Ludovic Courtès a719036099
doc: Update release instructions.
* doc/release.org (Add a Git tag): Mention release candidates.
(Add a Cuirass jobset for branch 'version-X.Y.Z'): Mention Cuirass.
(Update web pages): Adjust for the new web site infrastructure.
(Update the on-line copy of the manual): Update.
2020-04-15 19:11:16 +02:00
Andreas Enge 6d0a4e2c05
doc: Add programme of the Guix Days 2020.
* doc/guix-days-2020/README: Add sections on the programme.
2020-02-22 16:22:37 +01:00
Pierre Neidhardt 4b2000ad12
doc: Add Guix Days 2020 notes on "The Perfect Setup".
* doc/guix-days-2020/perfect-setup.org: New file.
2020-02-17 11:59:17 +01:00
Pierre Neidhardt c374a8fd9a
doc: Add "Readability" section to Guix Days 2020 "Parameterized packages".
* doc/guix-days-2020/parameterized-packages-guix-days: Do it.
2020-02-17 11:26:46 +01:00
Pierre Neidhardt 26ea4ab4c6
doc: Fix typos in Guix Days 2020 "Parameterized packages".
* doc/guix-days-2020/parameterized-packages-guix-days: Do it.
2020-02-17 11:26:44 +01:00
Ludovic Courtès 358c56cd94
doc: Add notes from the Guix Days 2020.
* doc/guix-days-2020: New directory.
2020-02-14 14:55:32 +01:00
zimoun aa641d9b09
refcard: Use aliases. Update version to 1.0.1.
* doc/refcard/guix-refcard.lout: Use all aliases. Update version to 1.0.1.
* doc/refcard/build.scm: Update 'texlive-fonts-lm' supersedes by 'texlive-lm'.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-11-06 15:37:33 +01:00
Ludovic Courtès 04597f6746
cuirass-howto: Explain how to retry an evaluation.
* doc/cuirass-howto.org (Retrying an evaluation): New section.
2019-10-15 11:36:26 +02:00
Ludovic Courtès 1398fe526a
doc: Add 'cuirass-howto.org'.
* doc/cuirass-howto.org: New file.
2019-10-15 10:17:39 +02:00
Julien Lepiller 91fc85ac6b
ROADMAP: Toggle web site and data service items.
* doc/ROADMAP.org (infrastructure): The web site and the Guix Data
Service are deployed.
2019-09-19 18:35:47 +02:00
Ludovic Courtès 7905f20eee
roadmap: Add references for the Guix System web UI. 2019-07-11 14:56:08 +02:00
Ludovic Courtès 71206ae7cf
ROADMAP: Move "GNOME Software" under "UI". 2019-07-04 15:00:14 +02:00
Pierre Neidhardt 6a5b1e4ada
doc: Comment on the possibility to specify a URL for config.scm.
* doc/ROADMAP.org (gnu installer): Do it.
2019-07-01 15:53:56 +02:00
Ludovic Courtès da47d3eb51
doc: Add roadmap.
* doc/ROADMAP.org: New file.
2019-07-01 11:34:19 +02:00
Ludovic Courtès 652e6ea41f
doc: Update 1.0 road map.
* doc/1.0.org: Update.
2019-07-01 11:32:33 +02:00
Ludovic Courtès 64324c3495
refcard: Document Guix System.
* doc/refcard/guix-refcard.lout (Managing the Operating System)
(Building and Running Containers, Building Virtual Machines)
(Building Operating System Images)
(Inspecting an Operating System, Declaring an Operating System): New
sections.
2019-05-03 10:56:59 +02:00
Ludovic Courtès 57c9ac5b5d
refcard: Suggest 'guix gc -d'.
* doc/refcard/guix-refcard.lout: Suggest 'guix gc -d'.
2019-05-03 10:55:41 +02:00
Ludovic Courtès 2be01fa206
doc: Change URLs to ftp.gnu.org.
* doc/release.org (Upload all the files)
(Prepare the email announcement): Change URL to ftp.gnu.org.
2019-05-01 22:50:02 +02:00