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
 

Reply via email to