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:24 UTC

[beam-site] 01/05: Fix broken links

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>.