Explaining faceting and the non trivial way to read and select facets is not easy. We could simplify things by renaming a few APIs around canonical concepts:
Possible renames are:
FullTextQuery.enableFaceting -> FullTextQuery.enableFacetingRequest
FullTextQuery.disableFaceting -> FullTextQuery.disableFacetingRequest
FacetManager.getFacets() -> FacetManager.getFacetGroup()
FacetManager.getFacetGroup() -> FacetManager.getFacetSelection()
This is more an example to get us talk on the subject than a fully fledged proposal but since we do break things in 5, it's a good time to start it.