diff --git a/docs/Changelog.md b/docs/Changelog.md
index ed8a9051ab5..08ca8e647e0 100644
--- a/docs/Changelog.md
+++ b/docs/Changelog.md
@@ -32,6 +32,7 @@
 * [#7341](https://github.com/TouK/nussknacker/pull/7341) Added possibility to choose presets and define lists for Integer typed parameter inputs in fragments.
 * [#7356](https://github.com/TouK/nussknacker/pull/7356) Integers converted to BigDecimals have scale 18,
   this fixes issue with unexpected low scale when performing division on BigDecimals which were created in such conversion.
+* [#7368](https://github.com/TouK/nussknacker/pull/7368) Component rename: `periodic` to `sample-generator`
 
 ## 1.18
 
diff --git a/docs/MigrationGuide.md b/docs/MigrationGuide.md
index 9137f2400d3..a71cfdf700b 100644
--- a/docs/MigrationGuide.md
+++ b/docs/MigrationGuide.md
@@ -29,6 +29,9 @@ To see the biggest differences please consult the [changelog](Changelog.md).
 * [#7347](https://github.com/TouK/nussknacker/pull/7347) All calls to `org.apache.flink.api.common.functions.RichFunction.open(Configuration)`,
   which is deprecated, were replaced with calls to `org.apache.flink.api.common.functions.RichFunction.open(OpenContext)`
 
+### Code API changes
+* [#7368](https://github.com/TouK/nussknacker/pull/7368) Renamed `PeriodicSourceFactory` to `SampleGeneratorSourceFactory`
+
 ## In version 1.18.0
 
 ### Configuration changes