Skip to content

Commit a41659b

Browse files
pinin4fjordsclaude
andcommitted
Clean up language and remove unnecessary dashes
- Add "Software Management" header for orphaned section - Tone down exclamations ("It worked!" -> "This works", "Much faster!" -> "Faster, because...") - Remove LLM phrase "worth mentioning" - Strip trailing dash phrases that added redundant emphasis - Tighten prose throughout Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 4245ff9 commit a41659b

1 file changed

Lines changed: 10 additions & 8 deletions

File tree

docs/side_quests/workflow_management_fundamentals.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -350,7 +350,7 @@ Check the results:
350350
ls results/
351351
```
352352

353-
It worked! But you have 3 samples (and 50 more coming).
353+
This works for one sample, but you have 3 samples (and 50 more coming).
354354
Running this command manually for each one isn't practical.
355355

356356
---
@@ -512,7 +512,7 @@ Notice the interleaved output - all samples running at once:
512512
[WT_REP2] Complete!
513513
```
514514

515-
Much faster!
515+
Faster, because all samples run concurrently.
516516

517517
#### The Hidden Problem
518518

@@ -677,6 +677,8 @@ Nextflow is a workflow manager. Instead of writing imperative scripts that say "
677677

678678
The key difference: in bash, you explicitly manage data flow with variables and file paths. In Nextflow, you declare what each process needs, and Nextflow figures out the execution order automatically.
679679

680+
#### Software Management
681+
680682
In Part 1, you installed FastQC, fastp, and Salmon with conda - hoping dependencies wouldn't conflict, documenting versions manually.
681683

682684
With Nextflow, each process declares its own software requirements. The tools are configured automatically at runtime with support for whichever software packaging tool you prefer. Your colleague runs the same pipeline and gets the exact same software environment based on the process definition, not their system.
@@ -720,11 +722,11 @@ Each part has a purpose:
720722
- **`output`** - Declares produced files with named channels (`emit: html`) for downstream processes
721723
- **`script`** - The actual command, nearly identical to your bash version
722724

723-
Notice you're not writing any loop logic, file existence checks, or error handling - Nextflow handles all of that.
725+
You're not writing any loop logic, file existence checks, or error handling.
724726

725727
!!! tip "Contrast with scripts"
726728

727-
The **one line** `container 'quay.io/biocontainers/fastqc:0.12.1--hdfd78af_0'` handles all software dependencies. The version is locked forever. Your colleague, your cluster, your cloud - all get the exact same FastQC.
729+
The **one line** `container 'quay.io/biocontainers/fastqc:0.12.1--hdfd78af_0'` handles all software dependencies. The version is locked forever. Your colleague, your cluster, and your cloud all get the exact same FastQC.
728730

729731
#### Call FASTQC in main.nf
730732

@@ -756,7 +758,7 @@ executor > local (3)
756758
[a1/b2c3d4] FASTQC (WT_REP1) [100%] 3 of 3 ✔
757759
```
758760

759-
**All 3 samples ran in parallel automatically.** In Part 1, you wrote `&` and `wait` and worried about resource limits. Nextflow figures out optimal parallelization from your process definition alone - no infrastructure code required.
761+
**All 3 samples ran in parallel automatically.** In Part 1, you wrote `&` and `wait` and worried about resource limits. Nextflow figures out optimal parallelization from your process definition alone.
760762

761763
---
762764

@@ -961,7 +963,7 @@ Watch what happens - Nextflow automatically determines the execution order from
961963

962964
!!! tip "Contrast with scripts"
963965

964-
In Part 1, you implemented `&` and `wait`, then worried about memory limits with 500 samples. Nextflow infers parallelization from the data flow and respects resource declarations - optimal scheduling without infrastructure code.
966+
In Part 1, you implemented `&` and `wait`, then worried about memory limits with 500 samples. Nextflow infers parallelization from the data flow and respects resource declarations.
965967

966968
---
967969

@@ -1010,7 +1012,7 @@ ch_multiqc = FASTQC.out.zip
10101012
MULTIQC(ch_multiqc)
10111013
```
10121014

1013-
The `.collect()` operator waits for all upstream processes to complete, then passes everything to MultiQC as a single batch. Nextflow tracks which files to collect automatically - you don't write any "wait for all jobs" logic.
1015+
The `.collect()` operator waits for all upstream processes to complete, then passes everything to MultiQC as a single batch. Nextflow tracks which files to collect automatically.
10141016

10151017
!!! tip "Contrast with scripts"
10161018

@@ -1124,7 +1126,7 @@ Building production-quality pipelines with scripts means writing significant inf
11241126

11251127
Workflow managers like Nextflow handle that infrastructure for you. You declare what each process needs and produces; the framework figures out the rest. The result is code that's almost entirely focused on your science, with production-quality features built in.
11261128

1127-
There's another benefit worth mentioning: **standardization**. Workflow managers are established tools with communities, documentation, and shared best practices. When you join a new team or project using one, you're working with familiar concepts rather than deciphering someone's homegrown scripting solution. Skills transfer. You're not maintaining custom infrastructure - you're using battle-tested tools that thousands of others rely on.
1129+
There's also **standardization**. Workflow managers are established tools with communities, documentation, and shared best practices. When you join a new team or project using one, you're working with familiar concepts rather than deciphering someone's homegrown scripting solution. Skills transfer. You're not maintaining custom infrastructure - you're using battle-tested tools that thousands of others rely on.
11281130

11291131
### What's Next?
11301132

0 commit comments

Comments
 (0)