Merge master into staging-next

            --arg beforeResultDir ./baseResult \

            --arg afterResultDir ./prResult \

            -o comparison

          cat comparison/step-summary.md >> "$GITHUB_STEP_SUMMARY"

          # TODO: Request reviews from maintainers for packages whose files are modified in the PR

      - name: Upload the combined results

          --slurpfile after ${afterResultDir}/outpaths.json \

          > $out/changed-paths.json

        jq -r -f ${./generate-step-summary.jq} < $out/changed-paths.json > $out/step-summary.md

        # TODO: Compare eval stats

      '';

def truncate(xs; n):

  if xs | length > n then xs[:n] + ["..."]

  else xs

  end;

def itemize_packages(xs):

  # we truncate the list to stay below the GitHub limit of 1MB per step summary.

  truncate(xs; 3000) | map("- [\(.)](https://search.nixos.org/packages?channel=unstable&show=\(.)&from=0&size=50&sort=relevance&type=packages&query=\(.))") | join("\n");

def section(title; xs):

  "<details> <summary>" + title + " (" + (xs | length | tostring) + ")</summary>\n\n" + itemize_packages(xs) + "</details>";

section("Added packages"; .attrdiff.added) + "\n\n" +

section("Removed packages"; .attrdiff.removed) + "\n\n" +

section("Changed packages"; .attrdiff.changed)

    github = "ribose-jeffreylau";

    githubId = 2649467;

  };

  ribru17 = {

    name = "Riley Bruins";

    email = "ribru17@hotmail.com";

    github = "ribru17";

    githubId = 55766287;

  };

  ricarch97 = {

    email = "ricardo.steijn97@gmail.com";

    github = "RicArch97";

    Refer to the `nixos-generate-config` step in

    [](#sec-installation) for more information.

    ::: {.note}

    On [UEFI](https://en.wikipedia.org/wiki/UEFI) systems, check that your `/etc/nixos/hardware-configuration.nix` did the right thing with the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition).

    In NixOS, by default, both [systemd-boot](https://systemd.io/BOOT/) and [grub](https://www.gnu.org/software/grub/index.html) expect it to be mounted on `/boot`.

    However, the configuration generator bases its [](#opt-fileSystems) configuration on the current mount points at the time it is run.

    If the current system and NixOS's bootloader configuration don't agree on where the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition) is to be mounted, you'll need to manually alter the mount point in `hardware-configuration.nix` before building the system closure.

    :::

    ::: {.note}

    The lustrate process will not work if the [](#opt-boot.initrd.systemd.enable) option is set to `true`.

    If you want to use this option, wait until after the first boot into the NixOS system to enable it and rebuild.

    :::

    You'll likely want to set a root password for your first boot using

    the configuration files because you won't have a chance to enter a

    password until after you reboot. You can initialize the root password

    $ echo etc/nixos | sudo tee -a /etc/NIXOS_LUSTRATE

    ```

1.  Finally, move the `/boot` directory of your current distribution out

    of the way (the lustrate process will take care of the rest once you

    reboot, but this one must be moved out now because NixOS needs to

    install its own boot files:

1.  Finally, install NixOS's boot system, backing up the current boot system's files in the process.

    The details of this step can vary depending on the bootloader configuration in NixOS and the bootloader in use by the current system.

    The commands below should work for:

    - [BIOS](https://en.wikipedia.org/wiki/BIOS) systems.

    - [UEFI](https://en.wikipedia.org/wiki/UEFI) systems where both the current system and NixOS mount the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition) on `/boot`.

      Both [systemd-boot](https://systemd.io/BOOT/) and [grub](https://www.gnu.org/software/grub/index.html) expect this by default in NixOS, but other distributions vary.

    ::: {.warning}

    Once you complete this step, your current distribution will no

    longer be bootable! If you didn't get all the NixOS configuration

    right, especially those settings pertaining to boot loading and root

    partition, NixOS may not be bootable either. Have a USB rescue

    device ready in case this happens.

    Once you complete this step, your current distribution will no longer be bootable!

    If you didn't get all the NixOS configuration right, especially those settings pertaining to boot loading and root partition, NixOS may not be bootable either.

    Have a USB rescue device ready in case this happens.

    :::

    ::: {.warning}

    On [UEFI](https://en.wikipedia.org/wiki/UEFI) systems, anything on the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition) will be removed by these commands, such as other coexisting OS's bootloaders.

    :::

    ```ShellSession

    $ sudo mv -v /boot /boot.bak &&

    sudo /nix/var/nix/profiles/system/bin/switch-to-configuration boot

    $ sudo mkdir /boot.bak && sudo mv /boot/* /boot.bak &&

    sudo NIXOS_INSTALL_BOOTLOADER=1 /nix/var/nix/profiles/system/bin/switch-to-configuration boot

    ```

    Cross your fingers, reboot, hopefully you should get a NixOS prompt!

    In other cases, most commonly where the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition) of the current system is instead mounted on `/boot/efi`, the goal is to:

    - Make sure `/boot` (and the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition), if mounted elsewhere) are mounted how the NixOS configuration would mount them.

    - Clear them of files related to the current system, backing them up outside of `/boot`.

      NixOS will move the backups into `/old-root` along with everything else when it first boots.

    - Instruct the NixOS closure built earlier to install its bootloader with:

      ```ShellSession

      sudo NIXOS_INSTALL_BOOTLOADER=1 /nix/var/nix/profiles/system/bin/switch-to-configuration boot

      ```

1.  If for some reason you want to revert to the old distribution,

    you'll need to boot on a USB rescue disk and do something along

    these lines: