diff --git a/UPGRADING.md b/UPGRADING.md
index 56c4ad14..64a672ae 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -21,3 +21,4 @@ $image = Image::useImageDriver(ImageDriver::Imagick)->load('path/to/image.jpg');
 
 ## Other changes
 - The option to create a manipulations instance has been removed.
+- the `border` method now accepts a BorderType enum value, and it's parameters have been reordered.
diff --git a/docs/image-manipulations/image-canvas.md b/docs/image-manipulations/image-canvas.md
index 7aa3905c..9c9e8ff9 100644
--- a/docs/image-manipulations/image-canvas.md
+++ b/docs/image-manipulations/image-canvas.md
@@ -17,10 +17,10 @@ $image->background('darkgray');
 
 ## Border
 
-The `border` method adds border with a certain `$width`, `$color` and `$borderType` to the `Image`. 
+The `border` method adds border with a certain `$width`, `$borderType` and `$color` to the `Image`. 
 
 ```php
-$image->border(15, '007698', Manipulations::BORDER_SHRINK);
+$image->border(15, BorderType::Shrink, '007698');
 ```
 
 ![Border](../../images/example-border.jpg)