You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beam.apache.org by me...@apache.org on 2017/07/12 22:56:23 UTC
[beam-site] branch mergebot updated (87326e1 -> 350bf24)
This is an automated email from the ASF dual-hosted git repository.
mergebot-role pushed a change to branch mergebot
in repository https://gitbox.apache.org/repos/asf/beam-site.git.
from 87326e1 This closes #273
add f88e604 Prepare repository for deployment.
new a0207d0 Fix broken links
new c1fe617 Update to latest version
new 6aee6f0 Address review comments
new 2c6b414 Address review comments
new 350bf24 This closes #271
The 5 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
content/contribute/contribution-guide/index.html | 16 ++++++++--------
src/contribute/ptransform-style-guide.md | 3 ++-
src/documentation/runners/direct.md | 2 +-
3 files changed, 11 insertions(+), 10 deletions(-)
--
To stop receiving notification emails like this one, please contact
['"commits@beam.apache.org" <co...@beam.apache.org>'].
[beam-site] 02/05: Update to latest version
Posted by me...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mergebot-role pushed a commit to branch mergebot
in repository https://gitbox.apache.org/repos/asf/beam-site.git
commit c1fe617c4c63fde5a1b422dbdd0a5254e5567754
Author: Maria Garcia Herrero <ma...@google.com>
AuthorDate: Wed Jul 12 08:27:55 2017 -0700
Update to latest version
---
src/contribute/ptransform-style-guide.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/src/contribute/ptransform-style-guide.md b/src/contribute/ptransform-style-guide.md
index 71b9860..933e31c 100644
--- a/src/contribute/ptransform-style-guide.md
+++ b/src/contribute/ptransform-style-guide.md
@@ -172,8 +172,8 @@ Data processing is tricky, full of corner cases, and difficult to debug, because
Do:
* Generally, follow the rules of [semantic versioning](http://semver.org/).
-* If the API of the transform is not yet stable, annotate it as `@Experimental` (Java) or `@experimental` ([python](https://beam.apache.org/documentation/sdks/pydoc/0.6.0/apache_beam.utils.html#module-apache_beam.utils.annotations)).
-* If the API deprecated, annotate it as `@Deprecated` (Java) or `@deprecated` ([python](https://beam.apache.org/documentation/sdks/pydoc/0.6.0/apache_beam.utils.html#module-apache_beam.utils.annotations)).
+* If the API of the transform is not yet stable, annotate it as `@Experimental` (Java) or `@experimental` ([python](https://beam.apache.org/documentation/sdks/pydoc/2.0.0/apache_beam.utils.html#module-apache_beam.utils.annotations)).
+* If the API deprecated, annotate it as `@Deprecated` (Java) or `@deprecated` ([python](https://beam.apache.org/documentation/sdks/pydoc/2.0.0/apache_beam.utils.html#module-apache_beam.utils.annotations)).
* Pay attention to the stability and versioning of third-party classes exposed by the transform's API: if they are unstable or improperly versioned (do not obey [semantic versioning](http://semver.org/)), it is better to wrap them in your own classes.
Do not:
--
To stop receiving notification emails like this one, please contact
"commits@beam.apache.org" <co...@beam.apache.org>.
[beam-site] 04/05: Address review comments
Posted by me...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mergebot-role pushed a commit to branch mergebot
in repository https://gitbox.apache.org/repos/asf/beam-site.git
commit 2c6b4142eaa948ddd03fb08a452e74734855e4de
Author: Maria Garcia Herrero <ma...@google.com>
AuthorDate: Wed Jul 12 15:20:30 2017 -0700
Address review comments
---
src/documentation/runners/direct.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/src/documentation/runners/direct.md b/src/documentation/runners/direct.md
index cd99eb5..5cca0de 100644
--- a/src/documentation/runners/direct.md
+++ b/src/documentation/runners/direct.md
@@ -27,10 +27,10 @@ Here are some resources with information about how to test your pipelines.
<ul>
<!-- Java specific links -->
<li class="language-java"><a href="{{ site.baseurl }}/blog/2016/10/20/test-stream.html">Testing Unbounded Pipelines in Apache Beam</a> talks about the use of Java classes <a href="{{ site.baseurl }}/documentation/sdks/javadoc/{{ site.release_latest }}/index.html?org/apache/beam/sdk/testing/PAssert.html">PAssert</a> and <a href="{{ site.baseurl }}/documentation/sdks/javadoc/{{ site.release_latest }}/index.html?org/apache/beam/sdk/testing/TestStream.html">TestStream</a> to test your pipe [...]
- <li class="language-java">The <a href="{{ site.baseurl }}/get-started/wordcount-example/#testing-your-pipeline-via-passert">Apache Beam WordCount Example</a> contains an example of logging and testing a pipeline with <a href="{{ site.baseurl }}/documentation/sdks/javadoc/{{ site.release_latest }}/index.html?org/apache/beam/sdk/testing/PAssert.html"><code>PAssert</code>.</li>
+ <li class="language-java">The <a href="{{ site.baseurl }}/get-started/wordcount-example/#testing-your-pipeline-via-passert">Apache Beam WordCount Example</a> contains an example of logging and testing a pipeline with <a href="{{ site.baseurl }}/documentation/sdks/javadoc/{{ site.release_latest }}/index.html?org/apache/beam/sdk/testing/PAssert.html"><code>PAssert</code></a>.</li>
<!-- Python specific links -->
- <li class="language-py">You can use <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/testing/util.py#L76">assert_that</a> to test your pipeline. The Python <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/examples/wordcount_debugging.py">WordCount Debugging Example</a> contains an example of logging and testing with <code>assert_that</code></a>.</li>
+ <li class="language-py">You can use <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/testing/util.py#L76">assert_that</a> to test your pipeline. The Python <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/examples/wordcount_debugging.py">WordCount Debugging Example</a> contains an example of logging and testing with <code>assert_that</code>.</li>
</ul>
## Direct Runner prerequisites and setup
--
To stop receiving notification emails like this one, please contact
"commits@beam.apache.org" <co...@beam.apache.org>.
[beam-site] 05/05: This closes #271
Posted by me...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mergebot-role pushed a commit to branch mergebot
in repository https://gitbox.apache.org/repos/asf/beam-site.git
commit 350bf242a0dc40c20680945df9f86464a4b5410a
Merge: f88e604 2c6b414
Author: Mergebot <me...@apache.org>
AuthorDate: Wed Jul 12 22:56:06 2017 +0000
This closes #271
src/contribute/ptransform-style-guide.md | 3 ++-
src/documentation/runners/direct.md | 2 +-
2 files changed, 3 insertions(+), 2 deletions(-)
--
To stop receiving notification emails like this one, please contact
"commits@beam.apache.org" <co...@beam.apache.org>.
[beam-site] 01/05: Fix broken links
Posted by me...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mergebot-role pushed a commit to branch mergebot
in repository https://gitbox.apache.org/repos/asf/beam-site.git
commit a0207d0f86cb05cb23fbe2f1a5821beb144bc8fd
Author: Maria Garcia Herrero <ma...@google.com>
AuthorDate: Tue Jul 11 16:22:40 2017 -0700
Fix broken links
---
src/contribute/ptransform-style-guide.md | 3 ++-
src/documentation/runners/direct.md | 2 +-
2 files changed, 3 insertions(+), 2 deletions(-)
diff --git a/src/contribute/ptransform-style-guide.md b/src/contribute/ptransform-style-guide.md
index 34f7c45..71b9860 100644
--- a/src/contribute/ptransform-style-guide.md
+++ b/src/contribute/ptransform-style-guide.md
@@ -172,7 +172,8 @@ Data processing is tricky, full of corner cases, and difficult to debug, because
Do:
* Generally, follow the rules of [semantic versioning](http://semver.org/).
-* If the API of the transform is not yet stable, mark it `@Experimental`.
+* If the API of the transform is not yet stable, annotate it as `@Experimental` (Java) or `@experimental` ([python](https://beam.apache.org/documentation/sdks/pydoc/0.6.0/apache_beam.utils.html#module-apache_beam.utils.annotations)).
+* If the API deprecated, annotate it as `@Deprecated` (Java) or `@deprecated` ([python](https://beam.apache.org/documentation/sdks/pydoc/0.6.0/apache_beam.utils.html#module-apache_beam.utils.annotations)).
* Pay attention to the stability and versioning of third-party classes exposed by the transform's API: if they are unstable or improperly versioned (do not obey [semantic versioning](http://semver.org/)), it is better to wrap them in your own classes.
Do not:
diff --git a/src/documentation/runners/direct.md b/src/documentation/runners/direct.md
index 5083ec7..b11976e 100644
--- a/src/documentation/runners/direct.md
+++ b/src/documentation/runners/direct.md
@@ -30,7 +30,7 @@ Here are some resources with information about how to test your pipelines.
<li class="language-java">The <a href="{{ site.baseurl }}/get-started/wordcount-example/#testing-your-pipeline-via-passert">Apache Beam WordCount Example</a> contains an example of logging and testing a pipeline with <a href="{{ site.baseurl }}/documentation/sdks/javadoc/{{ site.release_latest }}/index.html?org/apache/beam/sdk/testing/PAssert.html"><code>PAssert</code></a>.</li>
<!-- Python specific links -->
- <li class="language-py">You can use <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/transforms/util.py#L206">assert_that</a> to test your pipeline. The Python <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/examples/wordcount_debugging.py">WordCount Debugging Example</a> contains an example of logging and testing with <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/transforms/util.py#L206"><code>assert_ [...]
+ <li class="language-py">You can use <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/testing/util.py#L76">assert_that</a> to test your pipeline. The Python <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/examples/wordcount_debugging.py">WordCount Debugging Example</a> contains an example of logging and testing with <code>assert_that</code></a>.</li>
</ul>
## Direct Runner prerequisites and setup
--
To stop receiving notification emails like this one, please contact
"commits@beam.apache.org" <co...@beam.apache.org>.
[beam-site] 03/05: Address review comments
Posted by me...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mergebot-role pushed a commit to branch mergebot
in repository https://gitbox.apache.org/repos/asf/beam-site.git
commit 6aee6f034c4c472f229ef39c6d8a85282ced8afc
Author: Maria Garcia Herrero <ma...@google.com>
AuthorDate: Wed Jul 12 14:48:05 2017 -0700
Address review comments
---
src/contribute/ptransform-style-guide.md | 4 ++--
src/documentation/runners/direct.md | 2 +-
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/src/contribute/ptransform-style-guide.md b/src/contribute/ptransform-style-guide.md
index 933e31c..3624b02 100644
--- a/src/contribute/ptransform-style-guide.md
+++ b/src/contribute/ptransform-style-guide.md
@@ -172,8 +172,8 @@ Data processing is tricky, full of corner cases, and difficult to debug, because
Do:
* Generally, follow the rules of [semantic versioning](http://semver.org/).
-* If the API of the transform is not yet stable, annotate it as `@Experimental` (Java) or `@experimental` ([python](https://beam.apache.org/documentation/sdks/pydoc/2.0.0/apache_beam.utils.html#module-apache_beam.utils.annotations)).
-* If the API deprecated, annotate it as `@Deprecated` (Java) or `@deprecated` ([python](https://beam.apache.org/documentation/sdks/pydoc/2.0.0/apache_beam.utils.html#module-apache_beam.utils.annotations)).
+* If the API of the transform is not yet stable, annotate it as `@Experimental` (Java) or `@experimental` ([Python](https://beam.apache.org/documentation/sdks/pydoc/{{ site.release_latest }}/apache_beam.utils.html#module-apache_beam.utils.annotations)).
+* If the API deprecated, annotate it as `@Deprecated` (Java) or `@deprecated` ([Python](https://beam.apache.org/documentation/sdks/pydoc/{{ site.release_latest }}/apache_beam.utils.html#module-apache_beam.utils.annotations)).
* Pay attention to the stability and versioning of third-party classes exposed by the transform's API: if they are unstable or improperly versioned (do not obey [semantic versioning](http://semver.org/)), it is better to wrap them in your own classes.
Do not:
diff --git a/src/documentation/runners/direct.md b/src/documentation/runners/direct.md
index b11976e..cd99eb5 100644
--- a/src/documentation/runners/direct.md
+++ b/src/documentation/runners/direct.md
@@ -27,7 +27,7 @@ Here are some resources with information about how to test your pipelines.
<ul>
<!-- Java specific links -->
<li class="language-java"><a href="{{ site.baseurl }}/blog/2016/10/20/test-stream.html">Testing Unbounded Pipelines in Apache Beam</a> talks about the use of Java classes <a href="{{ site.baseurl }}/documentation/sdks/javadoc/{{ site.release_latest }}/index.html?org/apache/beam/sdk/testing/PAssert.html">PAssert</a> and <a href="{{ site.baseurl }}/documentation/sdks/javadoc/{{ site.release_latest }}/index.html?org/apache/beam/sdk/testing/TestStream.html">TestStream</a> to test your pipe [...]
- <li class="language-java">The <a href="{{ site.baseurl }}/get-started/wordcount-example/#testing-your-pipeline-via-passert">Apache Beam WordCount Example</a> contains an example of logging and testing a pipeline with <a href="{{ site.baseurl }}/documentation/sdks/javadoc/{{ site.release_latest }}/index.html?org/apache/beam/sdk/testing/PAssert.html"><code>PAssert</code></a>.</li>
+ <li class="language-java">The <a href="{{ site.baseurl }}/get-started/wordcount-example/#testing-your-pipeline-via-passert">Apache Beam WordCount Example</a> contains an example of logging and testing a pipeline with <a href="{{ site.baseurl }}/documentation/sdks/javadoc/{{ site.release_latest }}/index.html?org/apache/beam/sdk/testing/PAssert.html"><code>PAssert</code>.</li>
<!-- Python specific links -->
<li class="language-py">You can use <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/testing/util.py#L76">assert_that</a> to test your pipeline. The Python <a href="https://github.com/apache/beam/blob/master/sdks/python/apache_beam/examples/wordcount_debugging.py">WordCount Debugging Example</a> contains an example of logging and testing with <code>assert_that</code></a>.</li>
--
To stop receiving notification emails like this one, please contact
"commits@beam.apache.org" <co...@beam.apache.org>.