Improve data lineage docs

[ewels]

No description provided.

[netlify]

✅ Deploy Preview for nextflow-docs-staging canceled.

Name	Link
🔨 Latest commit	83f43f0
🔍 Latest deploy log	https://app.netlify.com/sites/nextflow-docs-staging/deploys/681e5a2a605bf00008eaf2e5

[pditommaso]

I think we should mark this feature as "Preview" in this release.

[jorgee]

I think we should mark this feature as "Preview" in this release.

Do you mean adding a warning message when lineage is activated? or adding workflow.preview option? I think the second is not needed as there is a specific lineage.enabled option, right?

[pditommaso]

Just in the docs

[bentsherman]

The lineage command is already marked as experimental in the docs

[pditommaso]

Good, worth adding the main lineage section

[bentsherman]

Not sure what you mean, there is no main lineage section

[bentsherman]

Rather, the lineage command is the main section

[bentsherman]

From our discussion today, I will add a guide for using data lineage so that we have something more comprehensive without bloating the CLI docs

[ewels]

Are we happy to merge this PR and do the guide in a different one @bentsherman ?

[bentsherman]

Ready to go. The guide covers all the basic usages, as well as the tips about global config and setting the output directory. It does not cover the use of labels because I don't have a real-world example on hand for that. We can work on that in a separate PR.

I was going to merge, but I'm being blocked by this failing google test. Not sure why it's failing on only some PRs.