Skip to content

ISC26: update the environments section#542

Merged
alecbcs merged 37 commits into
mainfrom
isc26/environments-update
Jun 19, 2026
Merged

ISC26: update the environments section#542
alecbcs merged 37 commits into
mainfrom
isc26/environments-update

Conversation

@alalazo

@alalazo alalazo commented Jun 18, 2026

Copy link
Copy Markdown
Member

depends on #535

Structural changes:

  • Replace the three-section introduction with a tighter motivation using a bullet list
  • Renamed "Environment Basics" -> "Working with environments"
    1. "Installing Packages" starts with the add -> concretize -> install workflow, so that is immediately taught to people
    2. "Using installed Packages" is a merge between the previous tcl and mpi use, which felt almost duplicated
    3. "Removing Packagse" now show the easy removal first, and the error later, so it progresses from easy to complex
  • Add a new "Environments on disk" section explaining the directory structure, spack.yaml and spack.lock
  • Restructure "Sharing environments" around a clear sender/recipient framing

Content changes:

  • The content has been updated for Spack v1.2 and Ubuntu 26.04

The output was generated using:

docker pull ghcr.io/alalazo/tutorial-buildcache:isc26@sha256:366369319e0ddee78cf9c727ba8004e7aff4e38068ba4f2ee532c2bceec9168d

alalazo added 30 commits June 16, 2026 09:11
This is so that audience is already aware
of where we are headin into, when we introduce
the various pieces (hash, store, etc.).
Also, consolidate all the use of `spack find`
This section introduces manifest and lockfile early.
This section introduces manifest and lockfile early.
This section introduces manifest and lockfile early.

@alecbcs alecbcs left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me. Will plan to follow up in another PR for specific wording changes.

@alecbcs alecbcs merged commit fdb8ced into main Jun 19, 2026
5 checks passed
@alecbcs alecbcs deleted the isc26/environments-update branch June 19, 2026 18:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants