This is an automated email from the ASF dual-hosted git repository.
fokko pushed a commit to branch production
in repository https://gitbox.apache.org/repos/asf/parquet-site.git
The following commit(s) were added to refs/heads/production by this push:
new 93e5cda PARQUET-2489: Guidance on Parquet-Java releases (#61)
93e5cda is described below
commit 93e5cda6268da8f980d00a9ed61ba1c8e180768b
Author: emkornfield <[email protected]>
AuthorDate: Wed Nov 13 04:33:09 2024 -0800
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]>
---
.../en/docs/Contribution Guidelines/releasing.md | 21 +++++++++++++++++++--
.../en/docs/Contribution Guidelines/sub-projects.md | 2 +-
2 files changed, 20 insertions(+), 3 deletions(-)
diff --git a/content/en/docs/Contribution Guidelines/releasing.md
b/content/en/docs/Contribution Guidelines/releasing.md
index 5a3dd62..c4a72f2 100644
--- a/content/en/docs/Contribution Guidelines/releasing.md
+++ b/content/en/docs/Contribution Guidelines/releasing.md
@@ -1,6 +1,6 @@
---
-title: "Releasing Parquet"
-linkTitle: "Releasing Parquet"
+title: "Releasing Parquet-Java"
+linkTitle: "Releasing Parquet-Java"
weight: 4
description: >
How to release Parquet-Java
@@ -8,6 +8,8 @@ description: >
### 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.
diff --git a/content/en/docs/Contribution Guidelines/sub-projects.md
b/content/en/docs/Contribution Guidelines/sub-projects.md
index 1577dfa..fc6bfa9 100644
--- a/content/en/docs/Contribution Guidelines/sub-projects.md
+++ b/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.
