Skip to content

ISC26: update the basics section#535

Merged
alecbcs merged 27 commits into
mainfrom
isc26/basics-update
Jun 19, 2026
Merged

ISC26: update the basics section#535
alecbcs merged 27 commits into
mainfrom
isc26/basics-update

Conversation

@alalazo

@alalazo alalazo commented Jun 16, 2026

Copy link
Copy Markdown
Member

This section has been reorganized, so that concepts are introduced in order rather than interleaved.

Structural changes:

  • Intro starts with a few fundamental ideas, that are illustrated in the rest of the tutorial
  • "The Spec Syntax" section consolidates all spec coverage into ordered subsections that build up one sigil at a time:
    1. Compiler flags are treated as an aside, instead of a central piece of the tutorial
    2. spack help --spec is the last subsection here
    3. Doesn't show spack find to avoid back and forth
  • "Querying Installations" section gathers all spack find usage (including the former "Advanced spack find Usage") in one place.
  • "A Realistic Example" section frames the Trilinos install

Content changes:

  • The content has been updated for Spack v1.2 and Ubuntu 26.04.
  • Doesn't show cflags= but shows +ipo and build_type=Debug instead in the Variants subsection.
  • Doesn't show virtual versioning (no mention of mpi@3).
  • Removed excessively long output - in particular spack graph for trilinos.

The output was generated using:

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

(see #536 for how that image was built) and editing the Makefile locally to point to that container image.

@alalazo alalazo marked this pull request as ready for review June 17, 2026 13:11
haampie pushed a commit to spack/spack-packages that referenced this pull request Jun 17, 2026
This follows from spack/spack-tutorial#535

Signed-off-by: Massimiliano Culpo <massimiliano.culpo@gmail.com>

@kshea21 kshea21 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Overall I really like what you did with this section! I just left some comments on language preferences, but nothing stood out that needs to change conceptually.

Comment thread tutorial_basics.rst Outdated
Comment thread tutorial_basics.rst Outdated
Comment thread tutorial_basics.rst Outdated
Comment thread tutorial_basics.rst Outdated
Comment thread tutorial_basics.rst Outdated
Comment thread tutorial_basics.rst Outdated
Comment thread tutorial_basics.rst Outdated
Comment thread tutorial_basics.rst Outdated
Comment thread tutorial_basics.rst Outdated
A Realistic Example
-------------------

Now that we know the spec syntax and how to query installations, let's put them to work on a realistic package.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Maybe knit-picking, but I don't think I like the term "realistic" here, all of the other examples were realistic installations someone could do as well

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Let me know if this seems better:
8f70bdf

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.

@kshea21 is on vacation today. Edits look good to me.

Comment thread tutorial_basics.rst Outdated
@alalazo

alalazo commented Jun 19, 2026

Copy link
Copy Markdown
Member Author

Thanks for the review @kshea21 ! I addressed the comments and went ahead closing the ones I "just accepted".

alalazo and others added 2 commits June 19, 2026 11:40
Signed-off-by: Alec Scott <alec@llnl.gov>
Signed-off-by: Alec Scott <alec@llnl.gov>

@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.

Changes look good to me. Thank you @alalazo for the in-depth review and rewrite.

@alecbcs alecbcs merged commit 94b0d95 into main Jun 19, 2026
5 checks passed
@alecbcs alecbcs deleted the isc26/basics-update branch June 19, 2026 18:48
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.

3 participants