Hi Sol,
We will update
our documentation to clearly show which search features are supported.
Technically we do not support search with OR pipes when using full search (search=frogs) or filter searches (filter=title.search:frogs). However, what you experienced is accurate, because when doing a full search the OR pipe has no effect and those pipes are removed. When searching with a filter, the OR pipes work to divide up the search into multiple searches. That's unintended, but it's a side effect of how we implemented the OR pipe to work with all filters.
We want to add more ways to search using OR, NOT operators, etc. But we need to think through it carefully and test it out. Hope that clears things up! Feel free to use the OR pipes within filter searches for now, as we would likely change that once we roll something else out.
Thanks,
Casey