From d044b5a298849a69d920330f6066633642c7d727 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jan=20Buscht=C3=B6ns?= Date: Tue, 4 Jun 2019 18:27:11 +0200 Subject: [PATCH] docs(README): explain `patch-package` --- README.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index f641367..418e4a5 100644 --- a/README.md +++ b/README.md @@ -330,13 +330,20 @@ Decorating generator methods with stage 1 decorators, is currently not possible, because of a bug in the stage 1 Babel parser. There already is a PR that will fix this and make the above syntax available for -stage 1 decorators. The fix is expected to be shipped with the next release of -Babel. +stage 1 decorators. The fix is expected to be shipped with the next minor +release of Babel (`v7.5.0`). You can find more information about this bug in issue [#48][issue-babel-bug]. [issue-babel-bug]: https://github.com/machty/ember-concurrency-decorators/issues/48 +If you don't want to wait until the fix is merged and released upstream, you can +use [`patch-package`][patch-package] or a similar technique to apply the patch +yourself. You can find an example of that in PR [#54][pr-patch-package]. + +[patch-package]: https://github.com/ds300/patch-package +[pr-patch-package]: https://github.com/machty/ember-concurrency-decorators/pull/54 + Please note that if you are using TypeScript, you likely still would not want to use this syntax, since it would lead to (false) type errors. See [TypeScript Support](#typescript-support) for more details.