diff --git a/README.adoc b/README.adoc
index a8c87017a0..4d8d7be104 100644
--- a/README.adoc
+++ b/README.adoc
@@ -108,8 +108,9 @@ Replace the repository with the one you currently work on.
 
 === 5. Implement the rule
 
-Implement the rule, update analyzer's metadata, and merge the rule implementation in your analyzer repository.
-Afterwards, merge the RSPEC pull request.
+Implement the rule as usual. +
+Merge the RSPEC pull request before updating the metadata of the analyzer otherwise `rule-api` will not work. +
+And finally, merge the rule implementation in your analyzer repository.
 
 ==== Generate/Update rule metadata for the analyzer