diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 3e2e5be63..2d70803e7 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,14 +1,14 @@
 # Description
 
-*Replace this paragraph with a description of what this PR is doing. 
+<!-- Provide a description of what this PR is doing. 
 If you're modifying existing behavior, describe the existing behavior, how this PR is changing it,
 and what motivated the change. If this is a breaking change, specify explicitly which APIs have been
-changed.*
+changed. -->
 
 ## Checklist
 
-Before you create this PR confirm that it meets all requirements listed below by checking the
-relevant checkboxes (`[x]`). This will ensure a smooth and quick review process.
+<!-- Before you create this PR confirm that it meets all requirements listed below by checking the
+relevant checkboxes (`[x]`). This will ensure a smooth and quick review process. -->
 
 - [ ] The title of my PR starts with a [Conventional Commit] prefix (`fix:`, `feat:`, `docs:` etc).
 - [ ] I have read the [Contributor Guide] and followed the process outlined for submitting PRs.
@@ -18,16 +18,18 @@ relevant checkboxes (`[x]`). This will ensure a smooth and quick review process.
 
 ## Breaking Change
 
-Does your PR require Flame users to manually update their apps to accommodate your change?
+<!-- Does your PR require Flame users to manually update their apps to accommodate your change? 
 
-- [ ] Yes, this is a breaking change. (Indicate it in the [Conventional Commit] prefix with a `!`,
-  e.g. `feat!:`, `fix!:`).
+If the PR is a breaking change this should be indicated with suffix "!"  (for example, `feat!:`, `fix!:`). See [Conventional Commit] for details.
+-->
+
+- [ ] Yes, this is a breaking change.
 - [ ] No, this is *not* a breaking change.
 
 ## Related Issues
 
-*Replace this paragraph with a list of issues related to this PR from the [issue database].
-Indicate which of these issues are resolved or fixed by this PR, i.e. Fixes #xxxx*
+<!-- Provide a list of issues related to this PR from the [issue database].
+Indicate which of these issues are resolved or fixed by this PR, i.e. Fixes #xxxx* !-->
 
 <!-- Links -->
 [issue database]: https://github.com/flame-engine/flame/issues