fix(docs): correct order of returned values

fix(docs): data flow image

feat(docs): add acknowledgement and release docs

feat: add shields