Abacn commented on code in PR #26987:
URL: https://github.com/apache/beam/pull/26987#discussion_r1235423032


##########
website/www/site/content/en/blog/managing-beam-dependencies-in-java.md:
##########
@@ -0,0 +1,122 @@
+---
+title:  "Managing Beam dependencies in Java"
+date:   2023-06-19 9:00:00 -0700
+categories:
+  - blog
+authors:
+  - bvolpato
+
+---
+<!--
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+Managing your Java dependencies can be challenging, and if not done correctly,
+it may cause a variety of problems, as incompatibilities may arise when using
+specific and previously untested combinations.
+
+To make that process easier, Beam now
+provides [Bill of Materials 
(BOM)](https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#bill-of-materials-bom-poms)
+artifacts that will help dependency management tools to select compatible
+combinations.
+
+We hope this will make it easier for you to use Apache Beam, and have a simpler
+transition when upgrading to newer versions.
+
+<!--more-->
+
+When bringing incompatible classes and libraries, the code is susceptible to
+errors such
+as `NoClassDefFoundError`, `NoSuchMethodError`, `NoSuchFieldError`, `FATAL 
ERROR in native method`.
+
+When importing Apache Beam, the recommended way is to use Bill of Materials
+(BOMs). The way BOMs work is by providing hints to the dependency management
+resolution tool, so when a project imports unspecified or ambiguous 
dependencies,
+it will know what version to use.
+
+There are currently two BOMs provided by Beam:
+
+- `beam-sdks-java-bom`, which manages what dependencies of Beam will be used, 
to

Review Comment:
   ```suggestion
   - `beam-sdks-java-bom`, which manages what dependencies of Beam will be 
used, so
   ```



##########
website/www/site/content/en/blog/managing-beam-dependencies-in-java.md:
##########
@@ -0,0 +1,122 @@
+---
+title:  "Managing Beam dependencies in Java"
+date:   2023-06-19 9:00:00 -0700
+categories:
+  - blog
+authors:
+  - bvolpato
+
+---
+<!--
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+Managing your Java dependencies can be challenging, and if not done correctly,
+it may cause a variety of problems, as incompatibilities may arise when using
+specific and previously untested combinations.
+
+To make that process easier, Beam now
+provides [Bill of Materials 
(BOM)](https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#bill-of-materials-bom-poms)
+artifacts that will help dependency management tools to select compatible
+combinations.
+
+We hope this will make it easier for you to use Apache Beam, and have a simpler
+transition when upgrading to newer versions.
+
+<!--more-->
+
+When bringing incompatible classes and libraries, the code is susceptible to
+errors such
+as `NoClassDefFoundError`, `NoSuchMethodError`, `NoSuchFieldError`, `FATAL 
ERROR in native method`.
+
+When importing Apache Beam, the recommended way is to use Bill of Materials
+(BOMs). The way BOMs work is by providing hints to the dependency management
+resolution tool, so when a project imports unspecified or ambiguous 
dependencies,
+it will know what version to use.
+
+There are currently two BOMs provided by Beam:
+
+- `beam-sdks-java-bom`, which manages what dependencies of Beam will be used, 
to
+  you can specify the version only once.
+- `beam-sdks-java-io-google-cloud-platform-bom`, a more comprehensive list,
+  which manages Beam, along with client and third-party dependencies.

Review Comment:
   ```suggestion
     which manages Beam, along with GCP client and third-party dependencies.
   ```



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to