You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@parquet.apache.org by sh...@apache.org on 2022/06/05 01:26:29 UTC
[parquet-site] branch production updated: Update website release docs
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 <vi...@gmail.com>
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 [announce@apache.org](mailto:announce@apache.org) and the dev list