REST documentation is confusing

At least one customer has been confused by our REST docs, which say (e.g.): /rest-service/search-v1/reviews?term &maxReturn, which leads people to just replace term with their query, instead of term=...