Docs: Update Gotchas page with comment clarifications
What does this MR do?
Update Gotchas page with comment clarifications
Follow-up from !18139 (comment 229927648)
Update Gotchas page with comment clarifications
Follow-up from !18139 (comment 229927648)