DOC: doc build fixes
DOC: expand gotchas/basics on boolean reductions