[Content Bug] Inconsistent use of api for compression about docs HOT 2 CLOSED

Both ways basically do the same things so cleaning up the docs by removing the = true part of the continuous aggs part seems the way to go.

from docs.

@antekresic I'm curious if it is the same case for materialized_only?

I like when we use the = true or = false as it seems more like a configuration style.

So, it means that:

ALTER MATERIALIZED VIEW contagg_view SET (timescaledb.compress = true);

is the same as:

ALTER MATERIALIZED VIEW contagg_view SET (timescaledb.compress);

As a rubyist my brain recognizes timescaledb.compress as a method call but in sql it looks reading a property of a relation and not configuring it. But ok, let's say the hidden assignment to true is being done, but maybe users will get confused that it's a method, and it will also start thinking it will be compressing immediately. In fact they'll need to setup a compression policy or compress manually.

When we toggle a configuration, my brain thinks something else should be done to apply this configuration, when we call the method, we think it can be doing both things at once. Not sure if I'm contributing or not but just thinking loud.

from docs.