TODO - get this listed on the Community Developed Lessons page once ready.
This lesson introduces the Snakemake workflow system in the context of a bioinformatics data analysis task.
To quote from the official Snakemake documentation:
The Snakemake workflow management system is a tool to create reproducible and scalable data analyses. Workflows are described via a human readable, Python based language. They can be seamlessly scaled to server, cluster, grid and cloud environments, without the need to modify the workflow definition. Finally, Snakemake workflows can entail a description of required software, which will be automatically deployed to any execution environment.
Snakemake originated as, and remains most popular as, a tool for bioinformatics. This is how we present it here. However, Snakemake is a general-purpose system and may be used for all manner of data processing tasks.
Snakemake is a superset of the Python language and as such can draw on the full power of Python, but you do not need to be a Python programmer to use it. This lesson assumes no prior knowledge of Python and intruduces just a few concepts as needed to construct useful workflows.
Before you begin developing your new lesson, here are a few things we recommend you do:
- [✓] Decide on a title for your new lesson!
Once you've chosen a new title, you can set the value for
lesson_title
in_config.yml
- Add the URL to your built lesson pages to the repository description*
- Add relevant topic tags to your lesson repository.
- Fill in the fields marked
FIXME
in:- this README
_config.yml
- [✓] If you're going to be developing lesson material for the first time according to our design principles, consider reading the Carpentries Curriculum Development Handbook
- [✓] Consult the Lesson Example website to find out more about working with the lesson template
- [✓] If you are planning to write your lesson in RMarkdown,
create a
gh-pages
branch and set this as the default branch in your repository settings - Update this README with relevant information about your lesson and delete this section
* To set the URL on GitHub, click the gear wheel button next to About on the right of the repository landing page. The lesson URL structure is https://carpentries-incubator.github.io/<repository-slug>: a repository at https://github.com/carpentries-incubator/new-lesson/ will have pages at the lesson URL https://carpentries-incubator.github.io/new-lesson/.
We welcome all contributions to improve the lesson! Maintainers will do their best to help you if you have any questions, concerns, or experience any difficulties along the way.
We'd like to ask you to familiarize yourself with our Contribution Guide and have a look at the more detailed guidelines on proper formatting, ways to render the lesson locally, and even how to write new episodes.
Please see the current list of [issues][FIXME] for ideas for contributing to this repository. For making your contribution, we use the GitHub flow, which is nicely explained in the chapter Contributing to a Project in Pro Git by Scott Chacon. Look for the tag . This indicates that the maintainers will welcome a pull request fixing this issue.
Current maintainers of this lesson are
A list of contributors to the lesson can be found in AUTHORS
To cite this lesson, please consult with CITATION