| Index: sdk/lib/_internal/pub_generated/README.md
 | 
| diff --git a/sdk/lib/_internal/pub_generated/README.md b/sdk/lib/_internal/pub_generated/README.md
 | 
| new file mode 100644
 | 
| index 0000000000000000000000000000000000000000..903a085c0ea22528f5e117aef36e4663af296fec
 | 
| --- /dev/null
 | 
| +++ b/sdk/lib/_internal/pub_generated/README.md
 | 
| @@ -0,0 +1,18 @@
 | 
| +Pub is currently dogfooding the new Dart async/await syntax. Since the Dart VM
 | 
| +doesn't natively support it yet, we are using the [async-await][] compiler
 | 
| +package.
 | 
| +
 | 
| +[async-await]: https://github.com/dart-lang/async_await
 | 
| +
 | 
| +We run that to compile pub-using-await from sdk/lib/_internal/pub down to
 | 
| +vanilla Dart code which is what you see here. To interoperate more easily with
 | 
| +the rest of the repositry, we check in that generated code.
 | 
| +
 | 
| +When bug #104 is fixed, we can remove this entirely.
 | 
| +
 | 
| +The code here was compiled using the async-await compiler at commit:
 | 
| +
 | 
| +    8b401a9f2e5e81dca5f70dbe7564112a0823dee6
 | 
| +
 | 
| +(Note: this file is also parsed by a tool to update the above commit, so be
 | 
| +careful not to reformat it.)
 | 
| 
 |