diff --git a/.changeset/compile_option.md b/.changeset/compile_option.md
index a1b566070..760f69315 100644
--- a/.changeset/compile_option.md
+++ b/.changeset/compile_option.md
@@ -2,4 +2,4 @@
 "@asyncapi/generator": minor
 ---
 
-Add compile option to enable rerun of transpilation for react templates
\ No newline at end of file
+Add `compile` option to enable rerun of transpilation of templates build with react engine. It is set to `true` by default. In future major releases it will be set to `false` and we will explain how to publish template to include transpilation files by default. Transpiled files are already included in [`html-template`](https://github.com/asyncapi/html-template/pull/575). It means that you can run generator for `html-template` (it's latest version) with `compile=false` and this will improve the speed of HTML generation for you.