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
alecbcs added a commit that referenced this pull request Jul 21, 2026
* ISC26: update the basics section (#535)

* Extend gitignore

* basics: split "Installing Packages" into subsections

* Add a paragraph explaining the overall spack architecture

This is so that audience is already aware
of where we are headin into, when we introduce
the various pieces (hash, store, etc.).

* Update releases/v1.1 -> releases/v1.2

* Move high-level highlights to introduction

* Minor fixes

* Shorten and improve "Installing Packages"

* Demote Compiler flags

* Reorder "Spec Syntax" subsections

* Move "Querying Installations" into its own section

Also, consolidate all the use of `spack find`

* Add intro to "Spec Syntax"

* Update output

* Fix "Installing Packages"

* Fix "Transitive Dependencies"

* Fix "Transitive Dependencies"

* Fix "Virtual Dependencies"

* First draft

* Add missing output

* Polish the section

* Polish the section

* Temporarily disable output generation

* Minor style fixes

* Minor style fixes

* Address review

* Don't use "realistic"

* Remove old output files after merge with main

Signed-off-by: Alec Scott <alec@llnl.gov>

---------

Signed-off-by: Alec Scott <alec@llnl.gov>
Co-authored-by: Alec Scott <alec@llnl.gov>

* ISC26: update the environments section (#542)

* Extend gitignore

* basics: split "Installing Packages" into subsections

* Add a paragraph explaining the overall spack architecture

This is so that audience is already aware
of where we are headin into, when we introduce
the various pieces (hash, store, etc.).

* Update releases/v1.1 -> releases/v1.2

* Move high-level highlights to introduction

* Minor fixes

* Shorten and improve "Installing Packages"

* Demote Compiler flags

* Reorder "Spec Syntax" subsections

* Move "Querying Installations" into its own section

Also, consolidate all the use of `spack find`

* Add intro to "Spec Syntax"

* Update output

* Fix "Installing Packages"

* Fix "Transitive Dependencies"

* Fix "Transitive Dependencies"

* Fix "Virtual Dependencies"

* First draft

* Add missing output

* Polish the section

* Polish the section

* Temporarily disable output generation

* Mechanical update of the environment section

* Minor fixes

* Don't use a non-matching temporary environment

* Shorten introduction, but maintain the same content

* Improved "Working with environments" section

* Improved "Working with environments" section

* Added an "Environment on disk" section

This section introduces manifest and lockfile early.

* Added an "Environment on disk" section

This section introduces manifest and lockfile early.

* Added an "Environment on disk" section

This section introduces manifest and lockfile early.

* Added a "Configuring environments" section

* Trimmed redundant section

* First complete draft of the "Environments" tutorial

* Minor fixes

* Minor fixes

* Less notes in the initial section

---------

Co-authored-by: Alec Scott <alec@llnl.gov>

* ISC26: update the stacks section (#544)

* Extend gitignore

* basics: split "Installing Packages" into subsections

* Add a paragraph explaining the overall spack architecture

This is so that audience is already aware
of where we are headin into, when we introduce
the various pieces (hash, store, etc.).

* Update releases/v1.1 -> releases/v1.2

* Move high-level highlights to introduction

* Minor fixes

* Shorten and improve "Installing Packages"

* Demote Compiler flags

* Reorder "Spec Syntax" subsections

* Move "Querying Installations" into its own section

Also, consolidate all the use of `spack find`

* Add intro to "Spec Syntax"

* Update output

* Fix "Installing Packages"

* Fix "Transitive Dependencies"

* Fix "Transitive Dependencies"

* Fix "Virtual Dependencies"

* First draft

* Add missing output

* Polish the section

* Polish the section

* Temporarily disable output generation

* Mechanical update of the environment section

* Minor fixes

* Don't use a non-matching temporary environment

* Shorten introduction, but maintain the same content

* Improved "Working with environments" section

* Improved "Working with environments" section

* Added an "Environment on disk" section

This section introduces manifest and lockfile early.

* Added an "Environment on disk" section

This section introduces manifest and lockfile early.

* Added an "Environment on disk" section

This section introduces manifest and lockfile early.

* Added a "Configuring environments" section

* Trimmed redundant section

* First complete draft of the "Environments" tutorial

* Minor fixes

* Minor fixes

* Less notes in the initial section

* Update Stacks to Ubuntu 26.04

* Add spec groups

* Fix last nits

* Fix last nits

---------

Co-authored-by: Alec Scott <alec@llnl.gov>

* ISC26: update the packaging section (#547)

* Extend gitignore

* basics: split "Installing Packages" into subsections

* Add a paragraph explaining the overall spack architecture

This is so that audience is already aware
of where we are headin into, when we introduce
the various pieces (hash, store, etc.).

* Update releases/v1.1 -> releases/v1.2

* Move high-level highlights to introduction

* Minor fixes

* Shorten and improve "Installing Packages"

* Demote Compiler flags

* Reorder "Spec Syntax" subsections

* Move "Querying Installations" into its own section

Also, consolidate all the use of `spack find`

* Add intro to "Spec Syntax"

* Update output

* Fix "Installing Packages"

* Fix "Transitive Dependencies"

* Fix "Transitive Dependencies"

* Fix "Virtual Dependencies"

* First draft

* Add missing output

* Polish the section

* Polish the section

* Temporarily disable output generation

* Minor style fixes

* Minor style fixes

* Address review

* Don't use "realistic"

* ISC26: update the Packaging section

---------

Co-authored-by: Alec Scott <alec@llnl.gov>

* ISC26: update index and setup header (#548)

* Extend gitignore

* basics: split "Installing Packages" into subsections

* Add a paragraph explaining the overall spack architecture

This is so that audience is already aware
of where we are headin into, when we introduce
the various pieces (hash, store, etc.).

* Update releases/v1.1 -> releases/v1.2

* Move high-level highlights to introduction

* Minor fixes

* Shorten and improve "Installing Packages"

* Demote Compiler flags

* Reorder "Spec Syntax" subsections

* Move "Querying Installations" into its own section

Also, consolidate all the use of `spack find`

* Add intro to "Spec Syntax"

* Update output

* Fix "Installing Packages"

* Fix "Transitive Dependencies"

* Fix "Transitive Dependencies"

* Fix "Virtual Dependencies"

* First draft

* Add missing output

* Polish the section

* Polish the section

* Temporarily disable output generation

* Minor style fixes

* Minor style fixes

* Address review

* Don't use "realistic"

* ISC26: update index and setup

---------

Co-authored-by: Alec Scott <alec@llnl.gov>

* Re-enable Output Generation CI/CD on PRs (#543)

I've tested the CI in this PR fully and rebased off of the latest commits to main. It adds back the CI/CD check to ensure that future edits must pass the checks before being able to be merged so that we don't accidentally break the tutorial this weekend before giving it on Monday.

---------

Signed-off-by: Alec Scott <alec@llnl.gov>
Co-authored-by: Massimiliano Culpo <massimiliano.culpo@gmail.com>

* build(deps): bump actions/checkout from 4.1.7 to 7.0.0 (#551)

Bumps [actions/checkout](https://github.com/actions/checkout) from 4.1.7 to 7.0.0.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v4.1.7...9c091bb)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: 7.0.0
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* build(deps): bump pytest from 9.1.0 to 9.1.1 (#558)

Bumps [pytest](https://github.com/pytest-dev/pytest) from 9.1.0 to 9.1.1.
- [Release notes](https://github.com/pytest-dev/pytest/releases)
- [Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](pytest-dev/pytest@9.1.0...9.1.1)

---
updated-dependencies:
- dependency-name: pytest
  dependency-version: 9.1.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* build(deps): bump actions/download-artifact from 4.1.8 to 8.0.1 (#556)

Bumps [actions/download-artifact](https://github.com/actions/download-artifact) from 4.1.8 to 8.0.1.
- [Release notes](https://github.com/actions/download-artifact/releases)
- [Commits](actions/download-artifact@fa0a91b...3e5f45b)

---
updated-dependencies:
- dependency-name: actions/download-artifact
  dependency-version: 8.0.1
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* build(deps): bump docker/setup-qemu-action from 3.2.0 to 4.1.0 (#554)

Bumps [docker/setup-qemu-action](https://github.com/docker/setup-qemu-action) from 3.2.0 to 4.1.0.
- [Release notes](https://github.com/docker/setup-qemu-action/releases)
- [Commits](docker/setup-qemu-action@49b3bc8...0611638)

---
updated-dependencies:
- dependency-name: docker/setup-qemu-action
  dependency-version: 4.1.0
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* build(deps): bump docker/build-push-action from 6.9.0 to 7.2.0 (#553)

Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 6.9.0 to 7.2.0.
- [Release notes](https://github.com/docker/build-push-action/releases)
- [Commits](docker/build-push-action@4f58ea7...f9f3042)

---
updated-dependencies:
- dependency-name: docker/build-push-action
  dependency-version: 7.2.0
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* build(deps): bump docker/login-action from 3.3.0 to 4.2.0 (#552)

Bumps [docker/login-action](https://github.com/docker/login-action) from 3.3.0 to 4.2.0.
- [Release notes](https://github.com/docker/login-action/releases)
- [Commits](docker/login-action@9780b0c...650006c)

---
updated-dependencies:
- dependency-name: docker/login-action
  dependency-version: 4.2.0
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* build(deps): bump ruamel-yaml from 0.18.15 to 0.19.1 (#555)

Bumps ruamel-yaml from 0.18.15 to 0.19.1.

---
updated-dependencies:
- dependency-name: ruamel-yaml
  dependency-version: 0.19.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* ISC26: small typo and grammar fixes in env and stacks sections (#559)

Signed-off-by: Alec Scott <alec@llnl.gov>

* build(deps): bump isort from 7.0.0 to 8.0.1 (#557)

Bumps [isort](https://github.com/PyCQA/isort) from 7.0.0 to 8.0.1.
- [Release notes](https://github.com/PyCQA/isort/releases)
- [Changelog](https://github.com/PyCQA/isort/blob/main/CHANGELOG.md)
- [Commits](PyCQA/isort@7.0.0...8.0.1)

---
updated-dependencies:
- dependency-name: isort
  dependency-version: 8.0.1
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* build(deps): bump docutils from 0.21.2 to 0.23

Bumps [docutils](https://github.com/rtfd/recommonmark) from 0.21.2 to 0.23.
- [Changelog](https://github.com/readthedocs/recommonmark/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rtfd/recommonmark/commits)

---
updated-dependencies:
- dependency-name: docutils
  dependency-version: '0.23'
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

---------

Signed-off-by: Alec Scott <alec@llnl.gov>
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: Massimiliano Culpo <massimiliano.culpo@gmail.com>
Co-authored-by: Alec Scott <alec@llnl.gov>
Co-authored-by: Alec Scott <hi@alecbcs.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
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