add illustration to docs/api.rst