clickhouse-docs
clickhouse-docs copied to clipboard
ClickHouse
Versions for each feature
ClickHouse gets new features constantly and continuously, and the new features, settings, configurations, ..etc. get documented regularly on https://clickhouse.com/docs. It will be so nice and useful if the docs mention when a new feature was introduced or changed.
For example, for lightweight deletes, it will be nice if the docs mentions when the feature:
- Was first introduced as an experimental feature
- Became production ready and available by default in the server
Another example would be for settings and configurations. If the default value of a server setting changed from x to y on version v, then it will be useful to mention in the docs that:
- The default value is
x. - And starting from version
v, the default value becamey.
Basically mentioning the history of features and default values.
And thanks so much for the great product, ClickHouse!
I've given this the X-Large size flag since it'll be a huge amount of work to go through all the existing docs/settings/functions/features and add this added in version XYZ status. I'm not saying we shouldn't do this -- having this status would be super valuable. I'm just setting expectations that this isn't an easy nor quick fix.
This would be a project all on it's own, similar to the functions-project the docs team is currently dealing with.
Yeah I understand it'd be a huge effort. Starting with the new features/changes would still be beneficial tho. And thanks a lot!
Opened an issue with an alternative solution https://github.com/ClickHouse/clickhouse-docs/issues/2492
