Add version to pipeline

Question

Is there any standard or recommended way to add a version number to a pipeline (written in snakemake in my case)?

For example, I have this pipeline and just now I added a CHANGELOG.md file with the current version on top. Are there better ways to identify the version a user is deploying?

Answer 1

There is a version directive, but I've never seen it used in practice:

# Snakefile
version: "1.2.3"

rule all:
   input: 'test.txt'

rule test:
   output: temp(touch('test.txt'))

There is an example/test for CWL conversion that uses version inside rule definition, where perhaps it might be useful, but otherwise the utility of including explicit version inside Snakefile is not clear.