# Clarify async/await language documentation\. · gitcafe/zig

[View on GitCafe](https://git.cafe/gitcafe/zig/commit/cfb2827b0a9efaf3937db27dbe3352cbb612466b)

Repository: [gitcafe/zig](https://git.cafe/gitcafe/zig)

Visibility: public

Requested revision: cfb2827b0a9efaf3937db27dbe3352cbb612466b

Requested commit: cfb2827b0a9efaf3937db27dbe3352cbb612466b

Commit: cfb2827b0a9efaf3937db27dbe3352cbb612466b

Tree: bc18678f1754d2f8a8010f99eb789e11baec0920

Author: bnprks

Committer: Veikka Tuominen

## Message

```
Clarify async/await language documentation.

The async/await documentation was somewhat hard for me to follow when first learning. Two particular sticking points were
1. The alphabet example constructing the string "abcdefghi" breaks the stated rule that every async has a matching await.
2. It was somewhat unclear to me what the rules for control flow were around async/await constructs.
I've tried to improve this documentation with some minimal explanatory edits, which are correct to the best of my beginner's understanding & experimentation.
```

## Parents

- [0cecdca6a24d5009d543962f62c907aa45ec82ff](https://git.cafe/gitcafe/zig/commit/0cecdca6a24d5009d543962f62c907aa45ec82ff?format=markdown)

[Source at this commit](https://git.cafe/gitcafe/zig/tree/cfb2827b0a9efaf3937db27dbe3352cbb612466b?format=markdown)