Resolve "AST-62: Update docs/design.md"

Closes #14 (closed) (and https://jira.skatelescope.org/browse/AST-62)

@offringa : let me know if you'd like to have any additional info on the current API