Skip to content

Add Hello nf-core training course #610

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 47 commits into from
Jun 4, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
1135a2b
Course structure
vdauwera May 9, 2025
0f6b03e
Add contents
vdauwera May 10, 2025
2d8f1a6
First section of hello nf-core
vdauwera May 10, 2025
6998635
Merge branch 'master' into gvda-hello-nf-core
vdauwera May 11, 2025
f5ec9c5
Add section 2 materials + update index
vdauwera May 12, 2025
4ec4bf8
small fix
vdauwera May 12, 2025
5513168
tiny fix
vdauwera May 12, 2025
11e2302
Add WoW Side Quest as a prelude
vdauwera May 12, 2025
cb0d5b3
Replace WoW case by Hello Nextflow original
vdauwera May 12, 2025
c40f120
fix modules location
vdauwera May 12, 2025
ef8c6e6
add greetings.csv input for nf-core
vdauwera May 12, 2025
844dc04
change dir name for starting case
vdauwera May 12, 2025
4dd4a30
original hello complete
vdauwera May 12, 2025
6f7d94a
composable workflow is composable
vdauwera May 13, 2025
b8a283e
nf-core conversion of hello nextflow complete
vdauwera May 13, 2025
a35a86c
fix note formatting
vdauwera May 13, 2025
0c43c02
change compliant to compatible to avoid overselling
vdauwera May 13, 2025
1e429db
fix numbers formatting
vdauwera May 13, 2025
06fa7eb
a few more minor fixes
vdauwera May 13, 2025
f7b512c
minor fixes
vdauwera May 13, 2025
7e933ce
Minor improvements to orientation and demo run section
vdauwera May 14, 2025
e6c3fc8
added schemas and example samplesheet details
vdauwera May 14, 2025
c403c48
Improved Hello rewrite
vdauwera May 14, 2025
03a6104
deleting due to weirdness
vdauwera May 14, 2025
2f72b53
Start and end states of core-hello (minus the git file)
vdauwera May 14, 2025
95db085
Improvements based on Summit trial run
vdauwera Jun 3, 2025
e95bc18
fixed headings
vdauwera Jun 3, 2025
ce429c0
Apply suggestions from Ken's code review
vdauwera Jun 4, 2025
dabcc5d
caught a straggler
vdauwera Jun 4, 2025
c4b37e0
prettier fix
vdauwera Jun 4, 2025
d75633d
Merge branch 'master' into gvda-hello-nf-core
vdauwera Jun 4, 2025
220e200
note formatting fix
vdauwera Jun 4, 2025
edba0a3
Merge branch 'gvda-hello-nf-core' of https://github.com/nextflow-io/t…
vdauwera Jun 4, 2025
a8d5142
Improve meta pages (especially next steps)
vdauwera Jun 4, 2025
5a8e113
Add survey page for hello nf-core
vdauwera Jun 4, 2025
b08d71f
Improve next steps pages
vdauwera Jun 4, 2025
70cd57c
Add next steps page to Genomics course too
vdauwera Jun 4, 2025
fb70c7f
Add logo to index page
vdauwera Jun 4, 2025
788b6d3
formatting fixes
vdauwera Jun 4, 2025
bffe780
formatting sub lists...
vdauwera Jun 4, 2025
c5ed364
nested lists fix?
vdauwera Jun 4, 2025
50a6843
workaround for nested lists not formatting correctly
vdauwera Jun 4, 2025
ea70e94
aaaargh
vdauwera Jun 4, 2025
98cdfa7
alternate attempt to previous
vdauwera Jun 4, 2025
7dd20f7
least objectionable workaround
vdauwera Jun 4, 2025
88213b3
a few more tweaks
vdauwera Jun 4, 2025
d62f157
Merge branch 'master' into gvda-hello-nf-core
vdauwera Jun 4, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 24 additions & 11 deletions docs/hello_nextflow/next_steps.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,35 +10,48 @@

Congrats again on completing the Hello Nextflow training course and thank you for completing our survey!

**Here are our top 3 recommendations for what you can do next to take your Nextflow skills to the next level.**
---

## 1. See how what you just learned applies to a scientific analysis use case
## 1. Top 3 ways to level up your Nextflow skills

Here are our top three recommendations for what to do next based on the course you just completed.

### 1.1. Apply Nextflow to a scientific analysis use case

**Check out the [Nextflow for Science](../nf4_science/index.md) page** for a list of short standalone courses that demonstrate how to apply the basic concepts and mechanisms presented in Hello Nextflow to common scientific analysis use cases.

If you don't see your domain represented by a relatable use case, let us know in the [Community forum](https://community.seqera.io/) so we can add it to our development list.

## 2. Delve into the details
### 1.2. Get started with nf-core

**[nf-core](https://nf-co.re/)** is a worldwide collaborative effort to develop standardized open-source pipelines for a wide range of scientific research applications.\*\*
The project includes [over 100 pipelines](https://nf-co.re/pipelines/) that are available for use out of the box and [well over 1400 process modules](https://nf-co.re/modules/) that can be integrated into your own projects, as well as a rich set of developer tools.

The **[Hello nf-core](../../hello_nf-core/index.md)** training course will introduce you to the nf-core community-curated pipelines and development framework, designed to help you write reproducible, scalable, and standardized workflows. You’ll learn how to use existing nf-core pipelines, contribute to their development, and even start building your own, supported by best practices and a vibrant community. If you’re ready to apply your Nextflow skills in real-world projects, this is the perfect next step.

### 1.3. Master more advanced Nextflow features

In the Hello Nextflow course, we keep the level of technical complexity low on purpose to avoid overloading you with information you don't need in order to get started with Nextflow.
As you move forward with your work, you're going to want to learn how to use the full feature set and power of Nextflow.

To that end, we are currently working on a collection of Side Quests, which are meant to be short standalone courses that go deep into specific topics like testing, metadata handling, using conditional statements and the differences between working on HPC _vs._ cloud.
To that end, we are currently working on a **collection of [Side Quests](../side_quests/index.md)**, which are meant to be short standalone courses that go deep into specific topics like testing, metadata handling, using conditional statements and the differences between working on HPC _vs._ cloud.

In the meantime, feel free to **browse the [Fundamentals Training](../basic_training/index.md) and [Advanced Training](../advanced/index.md)** to find training exercises about the topics that interest you.
For any topics that's not covered there yet, **browse the [Fundamentals Training](../basic_training/index.md) and [Advanced Training](../advanced/index.md)** to find training materials about the topics that interest you.

## 3. Learn how to use nf-core resources and the Seqera Platform
---

**The [nf-core project](https://nf-co.re/) is a worldwide collaborative effort to develop standardized open-source pipelines for a wide range of scientific research applications.**
It includes [over 100 pipelines](https://nf-co.re/pipelines/) that are available for use out of the box and [well over 1400 process modules](https://nf-co.re/modules/) that can be integrated into your own projects, as well as a rich set of developer tools.
## 2. Check out Seqera Platform

**[Seqera Platform](https://seqera.io/) is the best way to run Nextflow in practice.**
It is a cloud-based platform that you can connect to your own compute infrastructure to make it much easier to launch and manage your workflows.

It is a cloud-based platform developed by the creators of Nextflow that you can connect to your own compute infrastructure (whether local, HPC or cloud) to make it much easier to launch and manage your workflows, as well as manage your data and run analyses interactively in a cloud environment.

The Free Tier is available for free use by everyone (with usage quotas).
Qualifying academics can get free Pro-level access (no usage limitations) through the [Academic Program](https://seqera.typeform.com/to/SRB8Ci3n).

We are currently developing a short training course demonstrating how to use both of these resources (either independently or in combination).
In the meantime, check out the [nf-core docs](https://nf-co.re/docs/) and the [Seqera Platform tutorials](https://docs.seqera.io/platform/latest/getting-started/quickstart-demo/comm-showcase)
Have a look at the [Seqera Platform tutorials](https://docs.seqera.io/platform/latest/getting-started/quickstart-demo/comm-showcase) to see if this might be useful to you.

---

### That's it for now!

Expand Down
73 changes: 73 additions & 0 deletions docs/hello_nf-core/00_orientation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# Orientation

## GitHub Codespaces

The GitHub Codespaces environment contains all the software, code and data necessary to work through this training course, so you don't need to install anything yourself.
However, you do need a (free) GitHub account to log in, and you should take a few minutes to familiarize yourself with the interface.

If you have not yet done so, please go through the [Environment Setup](../../envsetup/) mini-course before going any further.

!!! warning

This training is designed for nf-core tools version 3.2.1, which should be the version installed in the codespace. If you use a different version of nf-core tooling you may have difficulty following along.

You can check what version is installed using the command`nf-core --version`.

## Working directory

Throughout this training course, we'll be working in the `hello-nf-core/` directory.

Change directory now by running this command in the terminal:

```bash
cd hello-nf-core/
```

!!! tip

If for whatever reason you move out of this directory, you can always use the full path to return to it, assuming you're running this within the Github Codespaces training environment:

```bash
cd /workspaces/training/hello-nf-core
```

Now let's have a look at the contents of this directory.

## Materials provided

You can explore the contents of this directory by using the file explorer on the left-hand side of the training workspace.
Alternatively, you can use the `tree` command.

Throughout the course, we use the output of `tree` to represent directory structure and contents in a readable form, sometimes with minor modifications for clarity.

Here we generate a table of contents to the second level down:

```bash
tree . -L 2
```

If you run this inside `hello-nf-core`, you should see the following output:

```console title="Directory contents"
.
├── greetings.csv
├── original-hello
│ ├── hello.nf
│ ├── modules
│ └── nextflow.config
└── solutions
└── composable-hello

4 directories, 3 files
```

**Here's a summary of what you should know to get started:**

- **The `greetings.csv` file** is a CSV containing some minimal columnar data we use for testing purposes.

- **The `original-hello` directory** contains a copy of the source code produced by working through the complete Hello Nextflow training series (with Docker enabled).

- **The `solutions` directory** contains the completed workflow scripts that result from each step of the course.
They are intended to be used as a reference to check your work and troubleshoot any issues.

**Now, to begin the course, click on the arrow in the bottom right corner of this page.**
Loading