Skip to content

docs: add admin documentation#436

Merged
cmeesters merged 12 commits intomainfrom
doc/admin-documentation
Mar 25, 2026
Merged

docs: add admin documentation#436
cmeesters merged 12 commits intomainfrom
doc/admin-documentation

Conversation

@fbartusch
Copy link
Copy Markdown
Collaborator

@fbartusch fbartusch commented Mar 13, 2026

Fixes #422

I tried to keep it short and concise. Please let me know if anything important is missing and I can add it.
I think the documentation in the Snakemake Cluster Profiles repo will improve in the future and will also contain valuable information for HPC admins.

Summary by CodeRabbit

  • Documentation
    • Added a short guide for HPC cluster administrators covering global vs. cluster-specific Snakemake profiles, the two-part profile structure (partition config and executor-oriented cluster profile), where to find template profiles, and user installation options (Conda, Spack, Easybuild). No changes to runtime behavior or plugin error handling.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Mar 13, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d09dd3e4-b793-41b0-a9a5-2c1a4391ebb9

📥 Commits

Reviewing files that changed from the base of the PR and between 8a98a37 and 1833f5b.

📒 Files selected for processing (1)
  • docs/further.md
✅ Files skipped from review due to trivial changes (1)
  • docs/further.md

Walkthrough

Added a new "Short Guide for HPC Cluster Administrators" to docs/further.md describing global Snakemake profile placement, cluster-specific profile structure (partition config + SLURM-oriented profile), template sources, and admin installation/deployment options. No code, behavior, or public API changes.

Changes

Cohort / File(s) Summary
Admin Documentation Guide
docs/further.md
Inserted a "Short Guide for HPC Cluster Administrators" section after the SLURM job guidance covering global profile location (/etc/xdg/snakemake), cluster profile structure (partition config + SLURM executor profile with latency and node-local scratch notes), pointer to snakemake-cluster-profiles templates, and installation/deployment options (Conda, Spack, Easybuild).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐇 I hopped in docs and left a tidy guide,
Where profiles live and cluster rules abide,
Templates gathered, installs mapped with care,
Admins now find the paths laid out there —
Hop, configure, run!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: add admin documentation' accurately describes the main change—adding a new admin documentation section to the plugin's documentation.
Linked Issues check ✅ Passed The PR directly addresses issue #422 by adding a dedicated 'for admin' documentation section covering configuration, cluster profiles, and administrator guidance as requested.
Out of Scope Changes check ✅ Passed The change is focused solely on adding administrative documentation to docs/further.md with no modifications to plugin code, configuration behavior, or error-handling.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc/admin-documentation

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@fbartusch fbartusch requested a review from cmeesters March 13, 2026 09:17
@cmeesters cmeesters marked this pull request as ready for review March 13, 2026 20:27
Copy link
Copy Markdown
Member

@cmeesters cmeesters left a comment

Choose a reason for hiding this comment

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

@fbartusch well, I like it. And once more: Thank you for making the first step! Yet, as I changed so much, please review and proofread carefully. I am absolutely open to change or add anything you like.

Please indicate any wish for change (e.g. by pushing it) or your agreement to merge (eventually).

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/further.md`:
- Line 850: Replace the misspelled word "deploymend" with "deployment" in the
sentence containing "To obtain a template for a cluster specific profile, search
at the [Snakemake cluster profiles repository]..." so the phrase reads
"...maintainer contacts and deployment hints."; update only that word to correct
the typo.
- Around line 846-850: Replace the unhyphenated compound adjectives in the
paragraph containing "Cluster specific profiles consist of two files:" by
updating the phrases: change "Cluster specific" to "Cluster-specific",
"Snakemake specific" to "Snakemake-specific", "node local" to "node-local", and
the later "cluster specific" to "cluster-specific" so all compound adjectives
are hyphenated consistently.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: de34f1cb-2838-4433-8ce9-aabb6608957c

📥 Commits

Reviewing files that changed from the base of the PR and between c4e3ec3 and eab88a9.

📒 Files selected for processing (1)
  • docs/further.md

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

♻️ Duplicate comments (1)
docs/further.md (1)

850-850: ⚠️ Potential issue | 🟡 Minor

Fix spelling error: "deploymend" → "deployment".

The word "deployment" is misspelled as "deploymend" in the documentation.

📝 Proposed fix
-To obtain a template for a cluster-specific profile, search at the [Snakemake cluster profiles repository](https://github.com/snakemake/snakemake-cluster-profiles). This repository not only provides configuration templates, but also maintainer contacts and deploymend hints.
+To obtain a template for a cluster-specific profile, search at the [Snakemake cluster profiles repository](https://github.com/snakemake/snakemake-cluster-profiles). This repository not only provides configuration templates, but also maintainer contacts and deployment hints.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/further.md` at line 850, Replace the misspelled word "deploymend" with
"deployment" in the sentence that reads "To obtain a template for a
cluster-specific profile, search at the [Snakemake cluster profiles
repository]... This repository not only provides configuration templates, but
also maintainer contacts and deploymend hints." — update the token "deploymend"
to "deployment" so the phrase becomes "deployment hints."
🧹 Nitpick comments (1)
docs/further.md (1)

852-852: Consider improving sentence structure for clarity.

The phrase "add this Slurm executor plugin, and their workflows" lacks parallel structure. Consider rephrasing to clarify what action users take with their workflows.

♻️ Suggested improvements

Option 1 (clarify that workflows are also added/installed):

-Your users will install Snakemake by Conda, add this Slurm executor plugin, and their workflows. Alternatively, Snakemake is provided by [Spack](https://packages.spack.io/package.html?name=snakemake) and [Easybuild](https://docs.easybuild.io/version-specific/supported-software/s/snakemake/), which both update regularly.
+Your users will install Snakemake via Conda, add this Slurm executor plugin, and configure their workflows. Alternatively, Snakemake is provided by [Spack](https://packages.spack.io/package.html?name=snakemake) and [Easybuild](https://docs.easybuild.io/version-specific/supported-software/s/snakemake/), which both update regularly.

Option 2 (restructure for better flow):

-Your users will install Snakemake by Conda, add this Slurm executor plugin, and their workflows. Alternatively, Snakemake is provided by [Spack](https://packages.spack.io/package.html?name=snakemake) and [Easybuild](https://docs.easybuild.io/version-specific/supported-software/s/snakemake/), which both update regularly.
+Your users will typically install Snakemake via Conda along with this Slurm executor plugin and their workflows. Alternatively, Snakemake is provided by [Spack](https://packages.spack.io/package.html?name=snakemake) and [Easybuild](https://docs.easybuild.io/version-specific/supported-software/s/snakemake/), which both update regularly.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/further.md` at line 852, The sentence containing "add this Slurm
executor plugin, and their workflows" is unbalanced; rephrase it for parallel
structure and clarity by making the actions uniform (e.g., "install Snakemake
via Conda, add the Slurm executor plugin, and install their workflows" or
"install Snakemake via Conda along with this Slurm executor plugin and their
workflows"); locate the sentence in the paragraph that starts with "Your users
will install Snakemake by Conda..." and replace it with one of these parallel
constructions.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@docs/further.md`:
- Line 850: Replace the misspelled word "deploymend" with "deployment" in the
sentence that reads "To obtain a template for a cluster-specific profile, search
at the [Snakemake cluster profiles repository]... This repository not only
provides configuration templates, but also maintainer contacts and deploymend
hints." — update the token "deploymend" to "deployment" so the phrase becomes
"deployment hints."

---

Nitpick comments:
In `@docs/further.md`:
- Line 852: The sentence containing "add this Slurm executor plugin, and their
workflows" is unbalanced; rephrase it for parallel structure and clarity by
making the actions uniform (e.g., "install Snakemake via Conda, add the Slurm
executor plugin, and install their workflows" or "install Snakemake via Conda
along with this Slurm executor plugin and their workflows"); locate the sentence
in the paragraph that starts with "Your users will install Snakemake by
Conda..." and replace it with one of these parallel constructions.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 62a40469-481e-4d45-a9dd-4ead83564b23

📥 Commits

Reviewing files that changed from the base of the PR and between eab88a9 and 8a98a37.

📒 Files selected for processing (1)
  • docs/further.md

@cmeesters cmeesters merged commit 8f7491f into main Mar 25, 2026
6 checks passed
@cmeesters cmeesters deleted the doc/admin-documentation branch March 25, 2026 08:58
cmeesters pushed a commit that referenced this pull request Mar 26, 2026
🤖 I have created a release *beep* *boop*
---


##
[2.6.0](v2.5.4...v2.6.0)
(2026-03-26)


### Features

* job arrays
([#174](#174))
([a51a5bf](a51a5bf))
* Set tmpspace with help of gres="tmpspace:10G" syntax
([#444](#444))
([c6f6658](c6f6658))


### Bug Fixes

* logo
([#439](#439))
([c4e3ec3](c4e3ec3))


### Documentation

* add admin documentation
([#436](#436))
([8f7491f](8f7491f))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **New Features**
  * Added support for job arrays
  * Added tmpspace configuration capability via `gres="tmpspace:10G"`

* **Bug Fixes**
  * Fixed logo display issue

* **Documentation**
  * Added admin documentation

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
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.

write "for admin" docs section

2 participants