Skip to content

Commit

Permalink
bump documentation versions and add release note for 8.1.0. (#801)
Browse files Browse the repository at this point in the history
  • Loading branch information
ahmetoz authored Dec 14, 2021
1 parent 2363de8 commit 120d4de
Show file tree
Hide file tree
Showing 17 changed files with 64 additions and 38 deletions.
16 changes: 8 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@
# commercetools sync
[![CI](https://github.com/commercetools/commercetools-sync-java/workflows/CI/badge.svg)](https://github.com/commercetools/commercetools-sync-java/actions?query=workflow%3ACI)
[![codecov](https://codecov.io/gh/commercetools/commercetools-sync-java/branch/master/graph/badge.svg)](https://codecov.io/gh/commercetools/commercetools-sync-java)
[![Benchmarks 8.0.0](https://img.shields.io/badge/Benchmarks-8.0.0-orange.svg)](https://commercetools.github.io/commercetools-sync-java/benchmarks/)
[![Download from Maven Central](https://img.shields.io/badge/Maven_Central-8.0.0-blue.svg)](https://search.maven.org/artifact/com.commercetools/commercetools-sync-java/8.0.0/jar)
[![Javadoc](https://javadoc.io/badge2/com.commercetools/commercetools-sync-java/javadoc.svg?label=Javadoc)](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/)
[![Benchmarks 8.1.0](https://img.shields.io/badge/Benchmarks-8.1.0-orange.svg)](https://commercetools.github.io/commercetools-sync-java/benchmarks/)
[![Download from Maven Central](https://img.shields.io/badge/Maven_Central-8.1.0-blue.svg)](https://search.maven.org/artifact/com.commercetools/commercetools-sync-java/8.1.0/jar)
[![Javadoc](https://javadoc.io/badge2/com.commercetools/commercetools-sync-java/javadoc.svg?label=Javadoc)](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/)
[![Known Vulnerabilities](https://snyk.io/test/github/commercetools/commercetools-sync-java/4b2e26113d591bda158217c5dc1cf80a88665646/badge.svg)](https://snyk.io/test/github/commercetools/commercetools-sync-java/4b2e26113d591bda158217c5dc1cf80a88665646)

More at https://commercetools.github.io/commercetools-sync-java
Expand All @@ -25,7 +25,7 @@ Supported resources: [Categories](/docs/usage/CATEGORY_SYNC.md), [Products](/doc
- [SBT](#sbt)
- [Ivy](#ivy)
- [Release Notes](/docs/RELEASE_NOTES.md)
- [Javadoc](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/)
- [Javadoc](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/)
- [Benchmarks](https://commercetools.github.io/commercetools-sync-java/benchmarks/)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->
Expand Down Expand Up @@ -60,26 +60,26 @@ Here are the most popular ones:
<dependency>
<groupId>com.commercetools</groupId>
<artifactId>commercetools-sync-java</artifactId>
<version>8.0.0</version>
<version>8.1.0</version>
</dependency>
````

#### Gradle

````groovy
implementation 'com.commercetools:commercetools-sync-java:8.0.0'
implementation 'com.commercetools:commercetools-sync-java:8.1.0'
````

#### SBT

````
libraryDependencies += "com.commercetools" % "commercetools-sync-java" % "8.0.0"
libraryDependencies += "com.commercetools" % "commercetools-sync-java" % "8.1.0"
````

#### Ivy

````xml
<dependency org="com.commercetools" name="commercetools-sync-java" rev="8.0.0"/>
<dependency org="com.commercetools" name="commercetools-sync-java" rev="8.1.0"/>
````

**Note**: To avoid `commercetools JVM SDK` libraries version mismatch between projects.
Expand Down
14 changes: 7 additions & 7 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@
# commercetools sync
[![CI](https://github.com/commercetools/commercetools-sync-java/workflows/CI/badge.svg)](https://github.com/commercetools/commercetools-sync-java/actions?query=workflow%3ACI)
[![codecov](https://codecov.io/gh/commercetools/commercetools-sync-java/branch/master/graph/badge.svg)](https://codecov.io/gh/commercetools/commercetools-sync-java)
[![Benchmarks 8.0.0](https://img.shields.io/badge/Benchmarks-8.0.0-orange.svg)](https://commercetools.github.io/commercetools-sync-java/benchmarks/)
[![Download from Maven Central](https://img.shields.io/badge/Maven_Central-8.0.0-blue.svg)](https://search.maven.org/artifact/com.commercetools/commercetools-sync-java/8.0.0/jar)
[![Javadoc](https://javadoc.io/badge2/com.commercetools/commercetools-sync-java/javadoc.svg?label=Javadoc)](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/)
[![Benchmarks 8.1.0](https://img.shields.io/badge/Benchmarks-8.1.0-orange.svg)](https://commercetools.github.io/commercetools-sync-java/benchmarks/)
[![Download from Maven Central](https://img.shields.io/badge/Maven_Central-8.1.0-blue.svg)](https://search.maven.org/artifact/com.commercetools/commercetools-sync-java/8.1.0/jar)
[![Javadoc](https://javadoc.io/badge2/com.commercetools/commercetools-sync-java/javadoc.svg?label=Javadoc)](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/)
[![Known Vulnerabilities](https://snyk.io/test/github/commercetools/commercetools-sync-java/4b2e26113d591bda158217c5dc1cf80a88665646/badge.svg)](https://snyk.io/test/github/commercetools/commercetools-sync-java/4b2e26113d591bda158217c5dc1cf80a88665646)


Expand Down Expand Up @@ -40,18 +40,18 @@ Here are the most popular ones:
<dependency>
<groupId>com.commercetools</groupId>
<artifactId>commercetools-sync-java</artifactId>
<version>8.0.0</version>
<version>8.1.0</version>
</dependency>
````
#### Gradle
````groovy
implementation 'com.commercetools:commercetools-sync-java:8.0.0'
implementation 'com.commercetools:commercetools-sync-java:8.1.0'
````
#### SBT
````
libraryDependencies += "com.commercetools" % "commercetools-sync-java" % "8.0.0"
libraryDependencies += "com.commercetools" % "commercetools-sync-java" % "8.1.0"
````
#### Ivy
````xml
<dependency org="com.commercetools" name="commercetools-sync-java" rev="8.0.0"/>
<dependency org="com.commercetools" name="commercetools-sync-java" rev="8.1.0"/>
````
26 changes: 26 additions & 0 deletions docs/RELEASE_NOTES.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,32 @@
7. Add Migration guide section which specifies explicitly if there are breaking changes and how to tackle them.
-->

### 8.1.0 - Dec 14, 2021
[Commits](https://github.com/commercetools/commercetools-sync-java/compare/8.0.0...8.1.0) |
[Javadoc](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/) |
[Jar](https://search.maven.org/artifact/com.commercetools/commercetools-sync-java/8.1.0/jar)

-**Build Tools**
- Migrated from gradle `v6.8.2` to [`v7.3.1`](https://togithub.com/gradle/gradle/releases/v7.3.1).
- Migrated github actions `setup-java` plugin from `v1` to [`v2`](https://togithub.com/actions/setup-java/compare/v1...v2)
- Migrated github actions `codecov-action` plugin from `v1` to [`v2`](https://togithub.com/codecov/codecov-action/compare/v1...v2)

- 🛠️ **Dependency Updates**
- `commercetools-jvm-sdk` `1.64.0` -> [`2.5.0`](http://commercetools.github.io/commercetools-jvm-sdk/apidocs/io/sphere/sdk/meta/ReleaseNotes.html#v2.5.0)
- `com.adarshr.test-logger` `3.0.0` -> [`3.1.0`](https://github.com/radarsh/gradle-test-logger-plugin/releases/tag/v3.1.0)
- `ru.vyarus.mkdocs` `2.1.2` -> [`2.2.0`](https://github.com/xvik/gradle-mkdocs-plugin/releases/tag/2.2.0)
- `org.ajoberstar.grgit` `4.1.0` -> [`4.1.1`](https://github.com/ajoberstar/grgit/releases/tag/4.1.1)
- `com.github.spotbugs` `4.7.1` -> [`5.0.2`](https://github.com/spotbugs/spotbugs-gradle-plugin/releases/tag/5.0.2)
- `com.diffplug.spotless` `5.14.2` -> `6.0.4`
- `mockito-junit-jupiter` `3.11.2` -> [`4.1.0`](https://github.com/mockito/mockito/releases/tag/v4.1.0)
- `org.junit.jupiter:junit-jupiter-api` `5.7.2` -> [`5.8.2`](https://junit.org/junit5/docs/snapshot/release-notes/index.html#release-notes-5.8.2)
- `org.junit.jupiter:junit-jupiter-engine` `5.7.2` -> [`5.8.2`](https://junit.org/junit5/docs/snapshot/release-notes/index.html#release-notes-5.8.2)
- `org.junit.jupiter:junit-jupiter-params` `5.7.2` -> [`5.8.2`](https://junit.org/junit5/docs/snapshot/release-notes/index.html#release-notes-5.8.2)
- `org.assertj.assertj-core` `3.20.2` -> [`3.21.0`](https://assertj.github.io/doc/#assertj-core-3-21-0-release-notes)
- `com.github.ben-manes.caffeine` `2.9.2` -> [`2.9.3`](https://github.com/ben-manes/caffeine/releases/tag/v2.9.3)
- (new) `org.apache.commons:common-text` [`1.9`](https://commons.apache.org/proper/commons-text/changes-report.html#a1.9)

### 8.0.0 - Oct 1, 2021
[Commits](https://github.com/commercetools/commercetools-sync-java/compare/7.0.2...8.0.0) |
[Javadoc](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/) |
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/CART_DISCOUNT_SYNC.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ against a [CartDiscountDraft](https://docs.commercetools.com/http-api-projects-c

#### SphereClient

Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.0.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.1.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
If you have custom requirements for the sphere client creation, have a look into the [Important Usage Tips](IMPORTANT_USAGE_TIPS.md).

````java
Expand Down Expand Up @@ -67,7 +67,7 @@ Therefore, in order to resolve the actual ids of those references in the sync pr
##### Syncing from a commercetools project

When syncing from a source commercetools project, you can use [`toCartDiscountDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/com/commercetools/sync/cartdiscounts/utils/CartDiscountTransformUtils.html#toCartDiscountDrafts-java.util.List-)
When syncing from a source commercetools project, you can use [`toCartDiscountDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/com/commercetools/sync/cartdiscounts/utils/CartDiscountTransformUtils.html#toCartDiscountDrafts-java.util.List-)
method that transforms(resolves by querying and caching key-id pairs) and maps from a `CartDiscount` to `CartDiscountDraft` using cache in order to make them ready for reference resolution by the sync, for example:

````java
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/CATEGORY_SYNC.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ against a [CategoryDraft](https://docs.commercetools.com/http-api-projects-categ

#### SphereClient

Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.0.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.1.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
If you have custom requirements for the sphere client creation, have a look into the [Important Usage Tips](IMPORTANT_USAGE_TIPS.md).

````java
Expand Down Expand Up @@ -135,7 +135,7 @@ As soon, as the referenced parent Category draft is supplied to the sync, the dr

##### Syncing from a commercetools project

When syncing from a source commercetools project, you can use [`toCategoryDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/com/commercetools/sync/categories/utils/CategoryTransformUtils.html#toCategoryDrafts-java.util.List-)
When syncing from a source commercetools project, you can use [`toCategoryDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/com/commercetools/sync/categories/utils/CategoryTransformUtils.html#toCategoryDrafts-java.util.List-)
method that transforms(resolves by querying and caching key-id pairs) and maps from a `Category` to `CategoryDraft` using cache in order to make them ready for reference resolution by the sync, for example:

````java
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/CUSTOMER_SYNC.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ against a [CustomerDraft](https://docs.commercetools.com/api/projects/customers#
### Prerequisites
#### SphereClient

Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.0.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.1.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
If you have custom requirements for the sphere client creation, have a look into the [Important Usage Tips](IMPORTANT_USAGE_TIPS.md).

````java
Expand Down Expand Up @@ -69,7 +69,7 @@ Therefore, in order to resolve the actual ids of those references in the sync pr
##### Syncing from a commercetools project

When syncing from a source commercetools project, you can use [`toCustomerDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/com/commercetools/sync/customers/utils/CustomerTransformUtils.html#toCustomerDrafts-java.util.List-)
When syncing from a source commercetools project, you can use [`toCustomerDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/com/commercetools/sync/customers/utils/CustomerTransformUtils.html#toCustomerDrafts-java.util.List-)
method that transforms(resolves by querying and caching key-id pairs) and maps from a `Customer` to `CustomerDraft` using cache in order to make them ready for reference resolution by the sync, for example:

````java
Expand Down
2 changes: 1 addition & 1 deletion docs/usage/CUSTOM_OBJECT_SYNC.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ against a [CustomObjectDraft](https://docs.commercetools.com/http-api-projects-c

#### SphereClient

Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.0.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.1.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
If you have custom requirements for the sphere client creation, have a look into the [Important Usage Tips](IMPORTANT_USAGE_TIPS.md).

````java
Expand Down
2 changes: 1 addition & 1 deletion docs/usage/IMPORTANT_USAGE_TIPS.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ productSync.sync(batch1)
By design, scaling the sync process should **not** be done by executing the batches themselves in parallel. However, it can be done either by:

- Changing the number of [max parallel requests](https://github.com/commercetools/commercetools-sync-java/tree/master/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L116) within the `sphereClient` configuration. It defines how many requests the client can execute in parallel.
- or changing the draft [batch size](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/com/commercetools/sync/commons/BaseSyncOptionsBuilder.html#batchSize-int-). It defines how many drafts can one batch contains.
- or changing the draft [batch size](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/com/commercetools/sync/commons/BaseSyncOptionsBuilder.html#batchSize-int-). It defines how many drafts can one batch contains.

The current overridable default [configuration](https://github.com/commercetools/commercetools-sync-java/tree/master/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) of the `sphereClient`
is the recommended good balance for stability and performance for the sync process.
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/INVENTORY_SYNC.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ against a [InventoryEntryDraft](https://docs.commercetools.com/http-api-projects

#### SphereClient

Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.0.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.1.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
If you have custom requirements for the sphere client creation, have a look into the [Important Usage Tips](IMPORTANT_USAGE_TIPS.md).

````java
Expand Down Expand Up @@ -68,7 +68,7 @@ Therefore, in order to resolve the actual ids of those references in the sync pr
##### Syncing from a commercetools project

When syncing from a source commercetools project, you can use [`toInventoryEntryDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/com/commercetools/sync/inventories/utils/InventoryTransformUtils.html#toInventoryEntryDrafts-java.util.List-)
When syncing from a source commercetools project, you can use [`toInventoryEntryDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/com/commercetools/sync/inventories/utils/InventoryTransformUtils.html#toInventoryEntryDrafts-java.util.List-)
method that transforms(resolves by querying and caching key-id pairs) and maps from a `InventoryEntry` to `InventoryEntryDraft` using cache in order to make them ready for reference resolution by the sync, for example:

````java
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/PRODUCT_SYNC.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ against a [ProductDraft](https://docs.commercetools.com/http-api-projects-produc

#### SphereClient

Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.0.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.1.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
If you have custom requirements for the sphere client creation, have a look into the [Important Usage Tips](IMPORTANT_USAGE_TIPS.md).

````java
Expand Down Expand Up @@ -80,7 +80,7 @@ resource on the target commercetools project and the library will issue an updat

##### Syncing from a commercetools project

When syncing from a source commercetools project, you can use [`toProductDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/com/commercetools/sync/products/utils/ProductTransformUtils.html#toProductDrafts-java.util.List-)
When syncing from a source commercetools project, you can use [`toProductDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/com/commercetools/sync/products/utils/ProductTransformUtils.html#toProductDrafts-java.util.List-)
method that transforms(resolves by querying and caching key-id pairs) and maps from a `Product` to `ProductDraft` using cache in order to make them ready for reference resolution by the sync, for example:

````java
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/PRODUCT_TYPE_SYNC.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ against a [ProductTypeDraft](https://docs.commercetools.com/http-api-projects-pr
### Prerequisites
#### SphereClient

Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.0.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
Use the [ClientConfigurationUtils](https://github.com/commercetools/commercetools-sync-java/blob/8.1.0/src/main/java/com/commercetools/sync/commons/utils/ClientConfigurationUtils.java#L45) which apply the best practices for `SphereClient` creation.
If you have custom requirements for the sphere client creation, have a look into the [Important Usage Tips](IMPORTANT_USAGE_TIPS.md).

````java
Expand Down Expand Up @@ -66,7 +66,7 @@ Therefore, in order to resolve the actual ids of those references in the sync pr
##### Syncing from a commercetools project

When syncing from a source commercetools project, you can use [`toProductTypeDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.0.0/com/commercetools/sync/producttypes/utils/ProductTypeTransformUtils.html#toProductTypeDrafts-java.util.List-)
When syncing from a source commercetools project, you can use [`toProductTypeDrafts`](https://commercetools.github.io/commercetools-sync-java/v/8.1.0/com/commercetools/sync/producttypes/utils/ProductTypeTransformUtils.html#toProductTypeDrafts-java.util.List-)
method that transforms(resolves by querying and caching key-id pairs) and maps from a `ProductType` to `ProductTypeDraft`. It can be configured to use a cache that will speed up the reference resolution performed during the sync, for example:

````java
Expand Down
Loading

0 comments on commit 120d4de

Please sign in to comment.