list search method conflicts in gotchas docs

[skip ci]
Fix allow_comments= to accept a parameter
Merge pull request #3701 from pranas/fix-allow-comments-deprecation

Fix allow_comments= to accept a parameter