Document desc stanza

[waldyrious]

Follow-up of Homebrew/brew#8137, which implemented #77696.

Related threads, for future reference:

• Add a description to cask #1790 (Add a description to cask)
• App categories + descriptions #3817 (App categories + descriptions)
• Casks short description #5192 (Casks short description)
• Formulae (info, search, etc) missing essential meta "description" #16089 (Formulae (info, search, etc) missing essential meta "description")

Note: The desc is currently added as an optional stanza. I've added descriptions to two casks (alfred, which is mentioned in the documentation, and fontforge, which was proposed as motivation in #77696). In Homebrew/brew#8137, @core-code proposed to contribute additional descs. Beyond this, I would suggest also importing/sourcing descriptions from Wikidata (example) and Repology (example).

[waldyrious]

The CI failures (name and desc stanza out of order) will be fixed with Homebrew/brew#8265. The order was encoded incorrectly in the previous PR, Homebrew/brew#8137.

Update: PR #8265 has been merged, so the tests in this one should now pass.

[core-code]

@core-code proposed to contribute additional descs.

ok, i've attached some descriptions. quality is very varying, i guess some are fine while would need adapting or replacement.

note that we've written some of those ourselves - in this case you can consider them public domain.
others are taken from description of the app on Mac App Store or from the description of the app from the homepage. in this case i guess they are copyrighted by the vendor. but i believe no vendor would have anything against using their description. its basically free promotion/marketing. also the copyrightability of such small text snippets could be disputed.

descriptions.txt

[waldyrious]

@core-code thanks a lot! I actually pinged you in this PR primarily for reference; I'd like to keep its diff relatively concise, and bulk-add descriptions in another PR. I'll take care of that separately if you don't mind. (Unless you'd like to submit them yourself — either way is fine by me!)

[core-code]

and bulk-add descriptions in another PR. I'll take care of that separately if you don't mind.

sounds good, please do

[reitermarkus]

Thanks, @waldyrious!