Skip to content

ISC26: update the basics section#535

Open
alalazo wants to merge 25 commits into
mainfrom
isc26/basics-update
Open

ISC26: update the basics section#535
alalazo wants to merge 25 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

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.

I think that there's a simpler way of explaining this than with wildcards?

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.

I went with:

Pass a substring to narrow the list.
For example, to see all Python packages:

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

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

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