You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beam.apache.org by "ASF GitHub Bot (JIRA)" <ji...@apache.org> on 2017/05/02 17:07:04 UTC
[jira] [Commented] (BEAM-1345) Mark @Experimental pieces of the SDK
that have been added but are not ready to be frozen
[ https://issues.apache.org/jira/browse/BEAM-1345?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15993293#comment-15993293 ]
ASF GitHub Bot commented on BEAM-1345:
--------------------------------------
GitHub user tgroh opened a pull request:
https://github.com/apache/beam/pull/2830
[BEAM-1345] Add an @Internal Annotation
Be sure to do all of the following to help us incorporate your contribution
quickly and easily:
- [ ] Make sure the PR title is formatted like:
`[BEAM-<Jira issue #>] Description of pull request`
- [ ] Make sure tests pass via `mvn clean verify`.
- [ ] Replace `<Jira issue #>` in the title with the actual Jira issue
number, if there is one.
- [ ] If this contribution is large, please file an Apache
[Individual Contributor License Agreement](https://www.apache.org/licenses/icla.pdf).
---
This annotation is used as a marker that a publicly accessible API is
intended for internal use and should not be used by users, and is
subject to no compatibility guarantees.
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/tgroh/beam add_internal_annotation
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/beam/pull/2830.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #2830
----
commit 7b3cce4da29bad280e42e2490ee3dc4ef5d4f763
Author: Thomas Groh <tg...@google.com>
Date: 2017-05-02T17:02:22Z
Add an @Internal Annotation
This annotation is used as a marker that a publicly accessible API is
intended for internal use and should not be used by users, and is
subject to no compatibility guarantees.
----
> Mark @Experimental pieces of the SDK that have been added but are not ready to be frozen
> ----------------------------------------------------------------------------------------
>
> Key: BEAM-1345
> URL: https://issues.apache.org/jira/browse/BEAM-1345
> Project: Beam
> Issue Type: Improvement
> Components: sdk-java-core, sdk-java-extensions, sdk-java-gcp
> Reporter: Kenneth Knowles
> Labels: backward-incompatible
> Fix For: First stable release
>
>
> A blanket JIRA to ensure that before a stable release we make sure to mark those pieces that would be unwise to freeze yet and consider how best to communicate this to users, who may just autocomplete those features in their IDE anyhow. (conversely, put infrastructure in place to enforce freezing of the rest)
> Not technically "backwards incompatible" with pre-Beam Dataflow SDKs, but certainly needs to be on the burndown for the first stable release.
--
This message was sent by Atlassian JIRA
(v6.3.15#6346)