Refactor: Make tutorial language consistent

Replaced instances of "let's do ...", "we will ...", and "the packager can ..."
with "you will ..." or passive voice equivalents across the following tutorial files:
- tutorial_advanced_packaging.rst
- tutorial_basics.rst
- tutorial_binary_cache.rst
- tutorial_buildsystems.rst

This change improves the consistency and clarity of the tutorial documentation.

Author: google-labs-jules[bot]

tutorial_advanced_packaging.rst

@@ -91,7 +91,7 @@ This section is focused on modifying the build-time environment represented by `
 :py:func:`setup_dependent_run_environment
 <spack.package.PackageBase.setup_dependent_run_environment>` function's ``env`` parameter, are included in Spack's automatically-generated module files.
 
-We can practice by editing the ``mpich`` package to set the ``MPICC`` environment variable in the build-time environment of dependent packages.
+You can practice by editing the ``mpich`` package to set the ``MPICC`` environment variable in the build-time environment of dependent packages.
 
 .. code-block:: console
 
@@ -113,7 +113,7 @@ Once you're finished, the method should look like this:
       spack_env.set('MPICH_F90', spack_fc)
       spack_env.set('MPICH_FC', spack_fc)
 
-At this point we can, for instance, install ``netlib-scalapack`` with ``mpich``:
+At this point you can, for instance, install ``netlib-scalapack`` with ``mpich``:
 
 .. code-block:: console
 
@@ -177,7 +177,7 @@ To contrast with ``qt``'s :py:func:`setup_dependent_build_environment <spack.pac
 
 It is not necessary to implement a ``setup_dependent_run_environment`` method for ``qt`` so one is not provided.
 
-Let's see how it works by completing the ``elpa`` package:
+You can see how it works by completing the ``elpa`` package:
 
 .. code-block:: console
 
@@ -301,7 +301,7 @@ Packages which don't follow this naming scheme must implement this function them
         )
 
 This issue is common for packages which implement an interface (i.e. virtual package providers in Spack).
-If we try to build another version of ``armadillo`` tied to ``netlib-lapack`` (``armadillo ^netlib-lapack ^mpich``) we'll notice that this time the installation won't complete:
+If you try to build another version of ``armadillo`` tied to ``netlib-lapack`` (``armadillo ^netlib-lapack ^mpich``) you'll notice that this time the installation won't complete:
 
 .. code-block:: console
 
@@ -331,14 +331,14 @@ If we try to build another version of ``armadillo`` tied to ``netlib-lapack`` (`
     /usr/local/var/spack/stage/arpack-ng-3.5.0-bloz7cqirpdxj33pg7uj32zs5likz2un/arpack-ng-3.5.0/spack-build-out.txt
 
 Unlike ``openblas`` which provides a library named ``libopenblas.so``, ``netlib-lapack`` provides ``liblapack.so``, so it needs to implement customized library search logic.
-Let's edit it:
+You can edit it:
 
 .. code-block:: console
 
   root@advanced-packaging-tutorial:/# spack edit netlib-lapack
 
 and follow the instructions in the ``# TUTORIAL:`` comment as before.
-What we need to implement is:
+What you need to implement is:
 
 .. code-block:: python
 
@@ -353,7 +353,7 @@ i.e., a property that returns the correct list of libraries for the LAPACK inter
 
 We use the name ``lapack_libs`` rather than ``libs`` because ``netlib-lapack`` can also provide ``blas``, and when it does it is provided as a separate library file.
 Using this name ensures that when dependents ask for ``lapack`` libraries, ``netlib-lapack`` will retrieve only the libraries associated with the ``lapack`` interface.
-Now we can finally install ``armadillo ^netlib-lapack ^mpich``:
+Now you can finally install ``armadillo ^netlib-lapack ^mpich``:
 
 .. code-block:: console
 
@@ -407,7 +407,7 @@ Extra query parameters
 An advanced feature of the Spec's build-interface protocol is the support for extra parameters after the subscript key.
 In fact, any of the keys used in the query can be followed by a comma-separated list of extra parameters which can be inspected by the package receiving the request to fine-tune a response.
 
-Let's look at an example and try to install ``netcdf ^mpich``:
+You can look at an example and try to install ``netcdf ^mpich``:
 
 .. code-block:: console
 
@@ -431,7 +431,7 @@ Let's look at an example and try to install ``netcdf ^mpich``:
     /usr/local/var/spack/stage/netcdf-4.4.1.1-gk2xxhbqijnrdwicawawcll4t3c7dvoj/netcdf-4.4.1.1/spack-build-out.txt
 
 We can see from the error that ``netcdf`` needs to know how to link the *high-level interface* of ``hdf5``, and thus passes the extra parameter ``hl`` after the request to retrieve it.
-Clearly the implementation in the ``hdf5`` package is not complete, and we need to fix it:
+Clearly the implementation in the ``hdf5`` package is not complete, and you need to fix it:
 
 .. code-block:: console
 
@@ -450,8 +450,8 @@ If you followed the instructions correctly, the code added to the ``lib`` proper
       libraries, root=self.prefix, shared=shared, recurse=True
   )
 
-where we highlighted the line retrieving the extra parameters.
-Now we can successfully complete the installation of ``netcdf ^mpich``:
+where the line retrieving the extra parameters is highlighted.
+Now you can successfully complete the installation of ``netcdf ^mpich``:
 
 .. code-block:: console
 

tutorial_basics.rst

@@ -9,10 +9,10 @@ Basic Installation Tutorial
 =========================================
 
 This tutorial will guide you through the process of installing software using Spack.
-We will first cover the ``spack install`` command, focusing on the power of the spec syntax and the flexibility it gives to users.
-We will also cover the ``spack find`` command for viewing installed packages and the ``spack uninstall`` command for uninstalling them.
-Finally, we will touch on how Spack manages compilers, especially as it relates to using Spack-built compilers within Spack.
-We will include full output from all of the commands demonstrated, although we will frequently call attention to only small portions of that output (or merely to the fact that it succeeded).
+You will first cover the ``spack install`` command, focusing on the power of the spec syntax and the flexibility it gives to users.
+You will also cover the ``spack find`` command for viewing installed packages and the ``spack uninstall`` command for uninstalling them.
+Finally, you will touch on how Spack manages compilers, especially as it relates to using Spack-built compilers within Spack.
+Full output from all of the commands demonstrated will be included, although attention will frequently be called to only small portions of that output (or merely to the fact that it succeeded).
 The provided output is all from an Ubuntu 22.04 Docker image.
 
 .. _basics-tutorial-install:
@@ -23,7 +23,7 @@ Installing Spack
 
 Spack works out of the box.
 Simply clone Spack to get going.
-We will clone Spack and immediately check out the most recent release, v0.23.
+You will clone Spack and immediately check out the most recent release, v0.23.
 
 .. literalinclude:: outputs/basics/clone.out
    :language: console
@@ -50,7 +50,7 @@ The ``spack list`` command shows available packages.
 
 The ``spack list`` command can also take a query string.
 Spack automatically adds wildcards to both ends of the string, or you can add your own wildcards.
-For example, we can view all available Python packages.
+For example, you can view all available Python packages.
 
 .. literalinclude:: outputs/basics/list-py.out
    :language: console
@@ -67,20 +67,20 @@ To install a piece of software simply type,
 
   $ spack install <package_name>
 
-Let's go ahead and install ``gmake``,
+You can go ahead and install ``gmake``,
 
 .. literalinclude:: outputs/basics/gmake.out
    :language: console
 
 You will see Spack installed ``gmake``, ``gcc-runtime``, and ``glibc``.
 The ``glibc`` and ``gcc-runtime`` packages are automatically tracked by Spack to manage consistency requirements among compiler runtimes.
 They do not represent separate software builds from source, but are records of the system's compiler runtime components Spack used for the install.
-For the rest of this section, we will ignore these components and focus on the packages explicitly installed.
+For the rest of this section, you will ignore these components and focus on the packages explicitly installed.
 
 Spack can install software either from source or from a binary cache.
 Packages in the binary cache are signed with GPG for security.
 For the tutorial we have prepared a binary cache so you don't have to wait on slow compilation from source.
-To be able to install from the binary cache, we will need to configure Spack with the location of the binary cache and trust the GPG key that the binary cache was signed with.
+To be able to install from the binary cache, you will need to configure Spack with the location of the binary cache and trust the GPG key that the binary cache was signed with.
 
 .. literalinclude:: outputs/basics/mirror.out
    :language: console
@@ -95,10 +95,10 @@ The ``%`` sigil is used to specify compilers.
    :language: console
 
 Note that this installation is located separately from the previous one.
-We will discuss this in more detail later, but this is part of what allows Spack to support many versions of software packages.
+This will be discussed in more detail later, but this is part of what allows Spack to support many versions of software packages.
 
 You can check for particular versions before requesting them.
-We will use the ``spack versions`` command to see the available versions, and then install a different version of ``zlib-ng``.
+You will use the ``spack versions`` command to see the available versions, and then install a different version of ``zlib-ng``.
 
 .. literalinclude:: outputs/basics/versions-zlib.out
    :language: console
@@ -132,7 +132,7 @@ The ``-l`` flag shows the hash of each package, and the ``-f`` flag shows any no
 Spack generates a hash for each spec.
 This hash is a function of the full provenance of the package, so any change to the spec affects the hash.
 Spack uses this value to compare specs and to generate unique installation directories for every combinatorial version.
-As we move into more complicated packages with software dependencies, we can see that Spack reuses existing packages to satisfy a dependency.
+As you move into more complicated packages with software dependencies, you can see that Spack reuses existing packages to satisfy a dependency.
 By default, Spack tries hard to reuse existing installations as dependencies, either from a local store or from configured remote binary caches.
 This minimizes unwanted rebuilds of common dependencies, in particular if you update Spack frequently.
 
@@ -141,14 +141,14 @@ This minimizes unwanted rebuilds of common dependencies, in particular if you up
 
 Dependencies can be explicitly requested using the ``^`` sigil.
 Note that the spec syntax is recursive.
-Anything we could specify about the top-level package, we can also specify about a dependency using ``^``.
+Anything you could specify about the top-level package, you can also specify about a dependency using ``^``.
 
 .. literalinclude:: outputs/basics/tcl-zlib-clang.out
    :language: console
 
 Packages can also be referred to from the command line by their package hash.
-Using the ``spack find -lf`` command earlier we saw that the hash of our optimized installation of zlib-ng (``cflags="-O3"``) began with ``umrbkwv``.
-We can now explicitly build with that package without typing the entire spec, by using the ``/`` sigil to refer to it by hash.
+Using the ``spack find -lf`` command earlier you saw that the hash of our optimized installation of zlib-ng (``cflags="-O3"``) began with ``umrbkwv``.
+You can now explicitly build with that package without typing the entire spec, by using the ``/`` sigil to refer to it by hash.
 As with other tools like Git, you do not need to specify an *entire* hash on the command line.
 You can specify just enough digits to identify a hash uniquely.
 If a hash prefix is ambiguous (i.e., two or more installed packages share the prefix) then Spack will report an error.
@@ -162,9 +162,9 @@ Note that each package has a top-level entry, even if it also appears as a depen
 .. literalinclude:: outputs/basics/find-ldf.out
    :language: console
 
-Let's move on to slightly more complicated packages.
+You can now move on to slightly more complicated packages.
 HDF5 is a good example of a more complicated package, with an MPI dependency.
-If we install it with default settings it will build with OpenMPI.
+If you install it with default settings it will build with OpenMPI.
 
 .. literalinclude:: outputs/basics/hdf5.out
    :language: console
@@ -174,60 +174,60 @@ Boolean variants can be specified using the ``+`` (enable) and ``~`` or ``-``
 (disable) sigils. There are two sigils for "disable" to avoid conflicts
 with shell parsing in different situations.
 Variants (boolean or otherwise) can also be specified using the same syntax as compiler flags.
-Here we can install HDF5 without MPI support.
+Here you can install HDF5 without MPI support.
 
 .. literalinclude:: outputs/basics/hdf5-no-mpi.out
    :language: console
 
-We might also want to install HDF5 with a different MPI implementation.
+You might also want to install HDF5 with a different MPI implementation.
 While ``mpi`` itself is a virtual package representing an interface, other packages can depend on such abstract interfaces.
 Spack handles these through "virtual dependencies." A package, such as HDF5, can depend on the ``mpi`` virtual package (the interface).
 Actual MPI implementation packages (like ``openmpi``, ``mpich``, ``mvapich2``, etc.) provide the MPI interface.
 Any of these providers can be requested to satisfy an MPI dependency.
-For example, we can build HDF5 with MPI support provided by MPICH by specifying a dependency on ``mpich`` (e.g., ``hdf5 ^mpich``).
+For example, you can build HDF5 with MPI support provided by MPICH by specifying a dependency on ``mpich`` (e.g., ``hdf5 ^mpich``).
 Spack also supports versioning of virtual dependencies.
 A package can depend on the MPI interface at version 3 (e.g., ``hdf5 ^mpi@3``), and provider packages specify what version of the interface *they* provide.
 The partial spec ``^mpi@3`` can be satisfied by any of several MPI implementation packages that provide MPI version 3.
 
 .. literalinclude:: outputs/basics/hdf5-hl-mpi.out
    :language: console
 
-We'll do a quick check in on what we have installed so far.
+You can do a quick check in on what you have installed so far.
 
 .. literalinclude:: outputs/basics/find-ldf-2.out
    :language: console
 
 Spack models the dependencies of packages as a directed acyclic graph (DAG).
 The ``spack find -d`` command shows the tree representation of that graph.
-We can also use the ``spack graph`` command to view the entire DAG as a graph.
+You can also use the ``spack graph`` command to view the entire DAG as a graph.
 
 .. literalinclude:: outputs/basics/graph-hdf5.out
    :language: console
 
 HDF5 is more complicated than our basic example of zlib-ng and Tcl, but it's still within the realm of software that an experienced HPC user could reasonably expect to manually install given a bit of time.
-Now let's look at an even more complicated package.
+Now you can look at an even more complicated package.
 
 .. literalinclude:: outputs/basics/trilinos.out
    :language: console
 
 Now we're starting to see the power of Spack.
 Trilinos in its default configuration has 23 direct dependencies, many of which have dependencies of their own.
 Installing more complex packages can take days or weeks even for an experienced user.
-Although we've done a binary installation for the tutorial, a source installation of Trilinos using Spack takes about 3 hours (depending on the system), but only 20 seconds of programmer time.
+Although a binary installation has been done for the tutorial, a source installation of Trilinos using Spack takes about 3 hours (depending on the system), but only 20 seconds of programmer time.
 
 Spack manages consistency of the entire DAG.
 Every MPI dependency will be satisfied by the same configuration of MPI, etc.
-If we install Trilinos again specifying a dependency on our previous HDF5 built with MPICH:
+If you install Trilinos again specifying a dependency on your previous HDF5 built with MPICH:
 
 .. literalinclude:: outputs/basics/trilinos-hdf5.out
    :language: console
 
-We see that every package in the Trilinos DAG that depends on MPI now uses MPICH.
+You will see that every package in the Trilinos DAG that depends on MPI now uses MPICH.
 
 .. literalinclude:: outputs/basics/find-d-trilinos.out
    :language: console
 
-As we discussed before, the ``spack find -d`` command shows the dependency information as a tree.
+As discussed before, the ``spack find -d`` command shows the dependency information as a tree.
 While that is often sufficient, many complicated packages, including Trilinos, have dependencies that cannot be fully represented as a tree.
 Again, the ``spack graph`` command shows the full DAG of the dependency information.
 
@@ -250,25 +250,25 @@ Uninstalling Packages
 ---------------------
 
 Earlier we installed many configurations each of zlib-ng and Tcl.
-Now we will go through and uninstall some of those packages that we didn't really need.
+Now you will go through and uninstall some of those packages that you didn't really need.
 
 .. literalinclude:: outputs/basics/find-d-tcl.out
    :language: console
 
 .. literalinclude:: outputs/basics/find-zlib.out
    :language: console
 
-We can uninstall packages by spec using the same syntax as install.
+You can uninstall packages by spec using the same syntax as install.
 
 .. literalinclude:: outputs/basics/uninstall-zlib.out
    :language: console
 
 .. literalinclude:: outputs/basics/find-lf-zlib.out
    :language: console
 
-We can also uninstall packages by referring only to their hash.
+You can also uninstall packages by referring only to their hash.
 
-We can use either the ``--force`` (or ``-f``) flag or the ``--dependents`` (or ``-R``) flag to remove packages that are required by another installed package.
+You can use either the ``--force`` (or ``-f``) flag or the ``--dependents`` (or ``-R``) flag to remove packages that are required by another installed package.
 Use ``--force`` to remove just the specified package, leaving dependents broken.
 Use ``--dependents`` to remove the specified package and all of its dependents.
 
@@ -291,10 +291,10 @@ The ``--all`` (or ``-a``) flag can be used to uninstall all packages matching an
 Advanced ``spack find`` Usage
 -----------------------------
 
-We will go over some additional uses for the ``spack find`` command not already covered in the :ref:`basics-tutorial-install` and
+You will go over some additional uses for the ``spack find`` command not already covered in the :ref:`basics-tutorial-install` and
 :ref:`basics-tutorial-uninstall` sections.
 
-The ``spack find`` command can accept what we call "anonymous specs." These are expressions in spec syntax that do not contain a package name.
+The ``spack find`` command can accept what are called "anonymous specs." These are expressions in spec syntax that do not contain a package name.
 For example, ``spack find ^mpich`` will return every installed package that depends on MPICH, and ``spack find cflags="-O3"`` will return every package which was built with ``cflags="-O3"``.
 
 .. literalinclude:: outputs/basics/find-dep-mpich.out
@@ -330,14 +330,14 @@ Spack also has tools to add compilers, and compilers built with Spack can be add
 .. literalinclude:: outputs/basics/find-p-gcc.out
    :language: console
 
-We can add GCC to Spack as an available compiler using the ``spack compiler add`` command.
+You can add GCC to Spack as an available compiler using the ``spack compiler add`` command.
 This will allow future packages to build with ``gcc@12.3.0``.
-To avoid having to copy and paste GCC's path, we can use ``spack location -i`` to get the installation prefix.
+To avoid having to copy and paste GCC's path, you can use ``spack location -i`` to get the installation prefix.
 
 .. literalinclude:: outputs/basics/compiler-add-location.out
    :language: console
 
-We can also remove compilers from our configuration using ``spack compiler remove <compiler_spec>``
+You can also remove compilers from your configuration using ``spack compiler remove <compiler_spec>``
 
 .. literalinclude:: outputs/basics/compiler-remove.out
    :language: console