Improving Alfred Gallery readme files

[Chris Messina]

Not sure if this feedback is for @Mr Pennyworth specifically, but he's mixed HTML and Markdown in his Cleanshot Workflow readme, which appears incorrectly in Alfred. Given that self-hosted Workflows will appear in the Gallery, I wonder if there should be either greater guidelines/requirements for the legibility of readme files or some other way to improve the appearance of this kind of documentation, like more Markdown support in Alfred's processor?

 

Here's how it looks on Github:

 

[Andrew]

15 hours ago, Chris Messina said:

I wonder if there should be either greater guidelines/requirements for the legibility of readme files or some other way to improve the appearance of this kind of documentation, like more Markdown support in Alfred's processor?

 

The start of this process is happening here:

https://www.alfredforum.com/topic/19058-submitting-workflows-for-the-alfred-gallery/

 

It's also worth noting that when workflows are submitted for inclusion in the gallery, we help developers tweak and fix things like this with either simple guidance, or Github PRs.

 

15 hours ago, Chris Messina said:

Given that self-hosted Workflows will appear in the Gallery

 

All workflows you download from the gallery are hosted by us. Self-hosted workflows (e.g. a Github release) are automatically picked up by our backend system for review, then signed and re-hosted by us. Once the Gallery is out of Early Access, you should always see nice clean readmes.