Fix workflow catalog table and revise documentation

[dgruano]

What & why

The Snakemake workflow catalog automatically parses the config.schema.yaml to build a parameter table. However, our current release breaks the table in the middle:

This happens right after the description field of atera parameters. Indeed, the problem is caused by the block chomping indicator (i.e. the little > before the long, multiline description). Starting the description with > leaves a trailing newline character that is parsed by snakemake inside the table, which breaks the formatting. Instead, >- should fix the parsing. We won't know for sure until we merge to main and release to the catalog, but should work.

Otherwise, I also include small doc changes that fix typos or improve readability. Feel free to chip in.

Opening as a stacked PR onto #2 and leaving it as a draft for now, as I may add new modifications

Validation

• mkdocs build --strict passes, if documentation was changed