add contribute
diff --git a/contribute.md b/contribute.md
new file mode 100644
index 0000000..e7c0a8b
--- /dev/null
+++ b/contribute.md
@@ -0,0 +1,65 @@
+---
+layout: doc
+title: "How to contribute"
+permalink: /docs/contribute.html
+---
+
+### Ask questions
+The Apache Griffin community is eager to help and to answer your questions. We have a dev/users mailing list.
+
+ - dev@griffin.incubator.apache.org , [To subscribe dev list](mailto:dev-subscribe@griffin.incubator.apache.org)
+ - users@griffin.incubator.apache.org , [To subscribe users list](mailto:users-subscribe@griffin.incubator.apache.org)
+
+### File a bug report
+Please let us know if you experienced a problem with Griffin and file a bug report. Open Griffin’s JIRA and click on the blue Create button at the top. Please give detailed information about the problem you encountered and, if possible, add a description that helps to reproduce the problem.
+
+[https://issues.apache.org/jira/browse/GRIFFIN](https://issues.apache.org/jira/browse/GRIFFIN)
+
+### Propose an improvement or a new feature
+Our community is constantly looking for feedback to improve Apache Griffin. If you have an idea how to improve Griffin or have a new feature in mind that would be beneficial for Griffin users, please open an issue in Griffin’s JIRA. The improvement or new feature should be described in appropriate detail and include the scope and its requirements if possible.
+
+We recommend to first reach consensus with the community on whether a new feature is required and how to implement a new feature, before starting with the implementation.
+
+[https://cwiki.apache.org/confluence/display/GRIFFIN/Apache+Griffin](https://cwiki.apache.org/confluence/display/GRIFFIN/Apache+Griffin)
+
+### Help others and join the discussions
+Most communication in the Apache Griffin community happens on two mailing lists:
+
+The user mailing lists user@griffin.incubator.apache.org is the place where users of Apache Griffin ask questions and seek for help or advice. Joining the user list and helping other users is a very good way to contribute to Griffin’s community.
+
+The development mailing list dev@griffin.incubator.apache.org is the place where Griffin developers exchange ideas and discuss new features, upcoming releases, and the development process in general. If you are interested in contributing code to Griffin, you should join this mailing list.
+
+You are welcome to subscribe to both mailing lists.
+
+### Contributing to Code
+Create jira ticket to specify what you want to do
+```
+create ticket here.
+https://issues.apache.org/jira/browse/GRIFFIN
+Create one new branch for this task
+
+# first fork this to your own repo -- https://github.com/apache/incubator-griffin.git
+# then clone your own repo to your local workspace
+git clone https://github.com/{YOURNAME}/incubator-griffin.git
+# code and push to your repository
+Commit and send PR to us
+
+#### please associate related JIRA TICK in your comments
+git commit -am "For task GRIFFIN-10 , blabla..."
+GRIFFIN PPMC will review and accept your pr as contributing.
+```
+
+
+### How to become a committer
+
+Committers are community members that have write access to the project’s repositories, i.e., they can modify the code, documentation, and website by themselves and also accept other contributions.
+
+There is no strict protocol for becoming a committer. Candidates for new committers are typically people that are active contributors and community members.
+
+Being an active community member means participating on mailing list discussions, helping to answer questions, verifying release candidates, being respectful towards others, and following the meritocratic principles of community management. Since the “Apache Way” has a strong focus on the project community, this part is very important.
+
+Of course, contributing code and documentation to the project is important as well. A good way to start is contributing improvements, new features, or bug fixes. You need to show that you take responsibility for the code that you contribute, add tests and documentation, and help maintaining it.
+
+Candidates for new committers are suggested by current committers or PMC members, and voted upon by the PMC.
+
+If you would like to become a committer, you should engage with the community and start contributing to Apache Griffin in any of the above ways. You might also want to talk to other committers and ask for their advice and guidance.
\ No newline at end of file
diff --git a/index.html b/index.html
index c413ad8..b5f8d88 100755
--- a/index.html
+++ b/index.html
@@ -97,8 +97,8 @@
</div>
</div>
- <div class="download" style="margin-left:10px;" title="Get Started"><a href="docs/quick-start.html">GET STARTED</a></div>
- <div class="download"><a href="docs/community.html" title="Contribute">CONTRIBUTE</a></div>
+ <div class="download" style="margin-left:10px;" title="Get Started"><a href="docs/quickstart.html">GET STARTED</a></div>
+ <div class="download"><a href="docs/contribute.html" title="Contribute">CONTRIBUTE</a></div>
</div>
</div>
diff --git a/quickstart.md b/quickstart.md
index 9922b49..14c5d83 100644
--- a/quickstart.md
+++ b/quickstart.md
@@ -8,6 +8,7 @@
Prepare the environment for Apache Griffin.
You can use our pre-built docker images as the environment.
Follow the [docker guide](https://github.com/apache/incubator-griffin/blob/master/griffin-doc/docker/griffin-docker-guide.md#environment-preparation) to start up the docker images, and login to the griffin container.
+
```
docker exec -it <griffin docker container id> bash
cd ~/measure
@@ -17,6 +18,7 @@
Prepare the test data in Hive.
In the docker image, we've prepared two Hive tables named `demo_src` and `demo_tgt`, and the test data is generated hourly.
The schema is like this:
+
```
id bigint
age int
@@ -24,6 +26,7 @@
dt string
hour string
```
+
In which `dt` and `hour` are the partition columns, with string values like `20180912` and `06`.
## Configuration Files
@@ -53,7 +56,9 @@
]
}
```
+
The DQ config file: dq.json
+
```
{
"name": "batch_accu",
@@ -120,12 +125,14 @@
## Submit Measure Job
Submit the measure job to Spark, with config file paths as parameters.
+
```
spark-submit --class org.apache.griffin.measure.Application --master yarn --deploy-mode client --queue default \
--driver-memory 1g --executor-memory 1g --num-executors 2 \
<path>/griffin-measure.jar \
<path>/env.json <path>/batch-accu-config.json
```
+
Then you can get the calculation log in console, after the job finishes, you can get the result metrics printed. The metrics will also be saved in hdfs: `hdfs:///griffin/persist/<job name>/<timestamp>/_METRICS`.
## More Details
