I was frustrated for hours when I couldn't figure out why this won't match:

>>> re.findall(r'(foo)?bar|cool', 'cool')

Now I know, I have to make this change: (?:foo)
But this isn't obvious.
Should it be mentioned in the docs of re.findall() to use (?:...) for non-capturing groups?