update example aegis.yaml

tidy

brought back handling of base64 values from api gateway stage variables

adjust test

adjust comment to make more sense

fix for iam role

more docs

link to documentation (wip)

a little help for local development

preliminary support for SES