This is to specifically ease the reviewing of healing related PRs. As we know, healing has more asynchronous decoupled tasks which we need to keep track to join our thoughts (specially during the review)

A design documentation, maybe with a design diagram would help to understand the process and differences between self-healing and admin-healing

Ideally we can keep track of the fore coming c

Default max-age Cache-control value in the project's README.md and tests suggest users to use very high value 630720000 (20y). RFC 2616 mentions the Expires value SHOULD NOT be more than 1y.

I suggest to use value of 31536000 (1y) in the doc/tests/examples to encourage this awesome project's users to be good netizens.

It's unclear from the README where you configure the s3 bucket and AWS credentials. I assume it's via the CircleCI UI, but it would be nice to be explicit!

Currently the doc's are just simple .rst files.
Need to improve with auto generated doc's with Sphinx.
And use sphinx automodule, doctest

Is there documentation explaining architecture and how to write new drivers.

Would love to contribute however need to have more information instead of just guessing from the existing code.