[ideas] description field for targets

[wlandau]

Discussed in #1230, posted by @tjmahr

^{Originally posted by tjmahr February 9, 2024}

Help

• I understand and agree to https://books.ropensci.org/targets/help.html.

Description

Sometimes I wish I had an description field for documenting what each target it is a more human-friendly way.

tar_target(
  name,
  command,
  description = "a field where we can briefly describe the target",
)

One could write a code comment, but this approach would be better because it could show up in tar_manifest(). It would also help generate READMEs.

Arguably, we should make the commands into simple functions and document those functions, but the trouble I have is having several end-products and recalling what they are.

[wlandau]

Descriptions could also power a new way to select and group targets: #1136 and #1196