This is an automated email from the ASF dual-hosted git repository.
shangxinli 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 0387231 Update website release docs
new 8bcec78 Merge pull request #25 from
vinooganesh/vinooganesh/updateWebsiteReleaseDocs
0387231 is described below
commit 0387231e1640a505bf0b78f66270c951fe9b8bbe
Author: Vinoo Ganesh <[email protected]>
AuthorDate: Thu Jun 2 09:33:55 2022 -0400
Update website release docs
---
.../docs/Contribution Guidelines/contributing.md | 25 +++++++++++++++++++++-
.../en/docs/Contribution Guidelines/releasing.md | 2 +-
2 files changed, 25 insertions(+), 2 deletions(-)
diff --git a/content/en/docs/Contribution Guidelines/contributing.md
b/content/en/docs/Contribution Guidelines/contributing.md
index a66c1b8..4ff1ce1 100644
--- a/content/en/docs/Contribution Guidelines/contributing.md
+++ b/content/en/docs/Contribution Guidelines/contributing.md
@@ -95,5 +95,28 @@ For now just say `n` as we have 1 branch
Website
-------
+### Release Documentation
-TODO
+To create documentation for a new release of `parquet-format` create a new
<releaseNumber>.md file under `content/en/blog/parquet-format`. Please see
existing files in that directory as an example.
+
+To create documentation for a new release of `parquet-mr` create a new
<releaseNumber>.md file under `content/en/blog/parquet-mr`. Please see existing
files in that directory as an example.
+
+### Website development and deployment
+
+#### Staging
+
+To make a change to the `staging` version of the website:
+1. Make a PR against the `staging` branch in the repository
+2. Once the PR is merged, the `Build and Deploy Parquet Site`
+job in the [deployment
workflow](https://github.com/apache/parquet-site/blob/staging/.github/workflows/deploy.yml)
will be run, populating the `asf-staging` branch on this repo with the
necessary files.
+
+**Do not directly edit the `asf-staging` branch of this repo**
+
+#### Production
+
+To make a change to the `production` version of the website:
+1. Make a PR against the `production` branch in the repository
+2. Once the PR is merged, the `Build and Deploy Parquet Site`
+job in the [deployment
workflow](https://github.com/apache/parquet-site/blob/production/.github/workflows/deploy.yml)
will be run, populating the `asf-site` branch on this repo with the necessary
files.
+
+**Do not directly edit the `asf-site` branch of this repo**
diff --git a/content/en/docs/Contribution Guidelines/releasing.md
b/content/en/docs/Contribution Guidelines/releasing.md
index 86a2d00..a020044 100644
--- a/content/en/docs/Contribution Guidelines/releasing.md
+++ b/content/en/docs/Contribution Guidelines/releasing.md
@@ -144,7 +144,7 @@ Then add and commit the release artifacts:
#### 4\. Update parquet.apache.org
-Update the downloads page on parquet.apache.org. Instructions for updating the
site are on the [contribution page](http://parquet.apache.org/contribute/).
+Update the downloads page on parquet.apache.org. Instructions for updating the
site are on the [contribution
page](http://parquet.apache.org/docs/contribution-guidelines/contributing/).
#### 5\. Send an ANNOUNCE e-mail to
[[email protected]](mailto:[email protected]) and the dev list