PARQUET-2489: Guidance on Parquet-Java releases (#61)

* DRAFT: Strawman proposal for releases

* cleanup based on updates to parquet format

* reflow

* Apply suggestions from code review

Co-authored-by: Joris Van den Bossche <[email protected]>

* update title

* Update content/en/docs/Contribution Guidelines/modules.md

Co-authored-by: Andrew Lamb <[email protected]>

* Add note that the steps are more or less the same as parquet-format.

---------

Co-authored-by: Joris Van den Bossche <[email protected]>
Co-authored-by: Andrew Lamb <[email protected]>

content/en/docs/Contribution Guidelines/releasing.md

@@ -1,13 +1,15 @@
 ---
-title: "Releasing Parquet"
-linkTitle: "Releasing Parquet"
+title: "Releasing Parquet-Java"
+linkTitle: "Releasing Parquet-Java"
 weight: 4
 description: >
   How to release Parquet-Java
 ---
 
 ### Setup
 
+N.B. The mechanics of releasing parquet-format is the same (e.g. setting up keys, branching, votes, etc)
+
 You will need: 
 
 - PGP code signing keys, published in [KEYS](https://downloads.apache.org/parquet/KEYS).
@@ -173,3 +175,18 @@ Add a [new release to GitHub](https://github.com/apache/parquet-java/releases/ne
     Java artifacts are available from Maven Central.
 
     Thanks to everyone for contributing!
+
+#### 6\. Update parquet-format with feature enablement guidance
+
+The recommendations for other feature enablement is generally tied to releases of
+parquet-java (details are in the parquet-format repo).  As releases are made the
+specification should be updated to indicate the recommended dates for when a new
+feature may be enabled.
+
+
+### Release Cadence
+
+Provided enough volunteers are available the Parquet community aims to have
+releases on a quarterly basis (Targets months are January, April, July and
+October). If a new major version is necessary it will be targetted for the
+October release.

content/en/docs/Contribution Guidelines/sub-projects.md

@@ -8,7 +8,7 @@ description: >
 
 The [parquet-format](https://github.com/apache/parquet-format) project contains format specifications and Thrift definitions of metadata required to properly read Parquet files.
 
-The [parquet-java](https://github.com/apache/parquet-java) project contains multiple sub-modules, which implement the core components of reading and writing a nested, column-oriented data stream, map this core onto the parquet format, and provide Hadoop Input/Output Formats, Pig loaders, and other Java-based utilities for interacting with Parquet.
+The [parquet-java](https://github.com/apache/parquet-java) project is a Java library to read and write Parquet files. It consists of multiple sub-modules, which implement the core components of reading and writing a nested, column-oriented data stream, to and from the Parquet format, along with Hadoop Input/Output Formats, Pig loaders, and other Java-based utilities for interacting with Parquet.
 
 The [parquet-cpp](https://arrow.apache.org/docs/cpp/parquet.html) project is a C++ library to read-write Parquet files. It is part of the [Apache Arrow](https://arrow.apache.org/) C++ implementation, with bindings to Python, R, Ruby and C/GLib.