Improve documentation

[kevgo]

Related issue

https://github.com/ory/docs/pull/182/files

Proposed changes

I think this is the source for the first line in https://github.com/ory/docs/blob/master/docs/keto/sdk/api.md.
The changes in this PR make the documentation that is derived from this read better.

Checklist

• I have read the contributing guidelines
• I have read the security policy
• I confirm that this pull request does not address a security vulnerability. If this pull request addresses a security
  vulnerability, I confirm that I got green light (please contact [email protected]) from the maintainers to push the changes.
• I have added tests that prove my fix is effective or that my feature works
• I have added necessary documentation within the code base (if appropriate)
• I have documented my changes in the developer guide (if appropriate)

Further comments

[kevgo]

Tests step curl -sL https://git.io/goreleaser | bash -s -- --snapshot --skip-publish --rm-dist fails with tar: This does not look like a tar archive. I assume this is unreleated to this change.

[aeneasr]

Yeah, totally - thank you! :)