Versioning the parquet format documentation

[alamb]

Problem Description

It is currently challenging to understand the state of what parquet features are available in what versions of what software implementations

This makes it hard to have confidence in what Parquet features can be used and yet still be read by the downstream ecosystem of interest. Thus it makes it hard to use newly added features in Parquet as it is not clear what systems will be unable to read them.

We do have https://parquet.apache.org/docs/file-format/implementationstatus/ but that does not include information about versions of parquet-format nor versions of the various implementations

Places it is mentioned:

• @wgtmac mentions it on https://github.com/apache/parquet-site/pull/38/files#r1460506762,
• https://lists.apache.org/thread/5qrcz8ps83hnd079dtzd1q6xm31zjbvh
• @pitrou also recently mentioned the value of a list of in what version each feature was added for each software on the implementation status page (but I can't find the link 🤔 )

Possible Solutions:

1. Version the parquet-format documentation more carefully (so we can refer to specific releases of parquet-format)
2. Add version information to the implementation status page

[pitrou]

• @pitrou also recently mentioned the value of a list of in what version each feature was added for each software on the implementation status page (but I can't find the link 🤔 )

That was suggested as part of apache/parquet-format#384

[pitrou]

Possible Solutions:

1. Version the `parquet-format` documentation more carefully (so we can refer to specific releases of parquet-format)

2. Add version information to the implementation status page

I think we can do both really.