Convert images to AVIF during API docs generation

[frankharkins]

Includes a feature flag as requested. This requires the user have ImageMagick installed.

[Eric-Arellano]

Thank you! Could you please document in the README prerequisites section that you need to install imagemagick and link to its install guide?

[frankharkins]

Could you please document in the README prerequisites section that you need to install imagemagick and link to its install guide?

Soft push back on this: Most users will have it installed already, and if they don't they'll immediately see the message explaining that they need it. It's also likely to become outdated if we ever change how the pipeline works.

[Eric-Arellano]

Soft push back on this: Most users will have it installed already, and if they don't they'll immediately see the message explaining that they need it. It's also likely to become outdated if we ever change how the pipeline works.

1. We will need it when you contribute to guides if you add new images, not only API docs. Fwiw, I'm fine with saying "You'll need imagemick if adding new images"
2. Why would most people have it installed already? I had to install it and it's not default on at least macOS

[Eric-Arellano]

My README suggestion isn't blocking. Thanks for adding the install to the console log!

[frankharkins]

I had to install it and it's not default on at least macOS

My mistake; I didn't need to install it so I assumed it came pre-installed with OSX, it must have been a dependency of something else.