Clarify 3.0-migration-guide.d/00README
Signed-off-by: Manuel Pégourié-Gonnard <manuel.pegourie-gonnard@arm.com>
diff --git a/docs/3.0-migration-guide.d/00README b/docs/3.0-migration-guide.d/00README
index dfcf248..0312594 100644
--- a/docs/3.0-migration-guide.d/00README
+++ b/docs/3.0-migration-guide.d/00README
@@ -11,20 +11,17 @@
particular feature? Remember to contextualise.
If I'm affected, what's my migration path? How should I change my code if this
-is and API change; if a feature was removed what are my alternatives?
-
-Optional: Another Change That Was Made in the Same Pr
------------------------------------------------------
-
-Who is affected?
-
-What's the migration path?
+is an API change; if a feature was removed what are my alternatives?
---%<------%<------%<------%<------%<------%<------%<------%<---
+PRs that make multiple independent changes should include one entry for each
+changes or logical groups of changes. You can either add multiple files or put
+multiple entries in the same file.
+
For examples, have a look a docs/3.0-migration-guide.md (which includes the
top-level header and an intro before the list of entries).
As part of release preparation, the entries in this directory will be appended
to docs/3.0-migration-guide.md and then re-ordered and reviewed one last time.
-The file is then going to be moved to the version-independant docs repo.
+The file is then going to be moved to the version-independent docs repo.