diff --git a/admin/src/Users/User.php b/admin/src/Users/User.php
index 146f220c..950a8e50 100644
--- a/admin/src/Users/User.php
+++ b/admin/src/Users/User.php
@@ -237,7 +237,7 @@ class User extends DataGetter
     /**
      * @inheritdoc
      *
-     * @deprecated
+     * @deprecated Access data directly from class methods
      */
     public function get($key, $default = null)
     {
diff --git a/formwork/Core/Page.php b/formwork/Core/Page.php
index 6f3c390b..fe311d45 100644
--- a/formwork/Core/Page.php
+++ b/formwork/Core/Page.php
@@ -49,7 +49,7 @@ class Page extends AbstractPage
      *
      * @var string
      *
-     * @deprecated
+     * @deprecated Use the name property
      */
     protected $id;
 
@@ -426,7 +426,7 @@ class Page extends AbstractPage
      *
      * @return string|null File path or null if file is not found
      *
-     * @deprecated
+     * @deprecated Access files from Page::files()
      */
     public function file(string $file): ?string
     {
diff --git a/formwork/Core/Site.php b/formwork/Core/Site.php
index 15d1319a..266fbf15 100644
--- a/formwork/Core/Site.php
+++ b/formwork/Core/Site.php
@@ -184,7 +184,7 @@ class Site extends AbstractPage
     /**
      * Get site language
      *
-     * @deprecated
+     * @deprecated Use Site::languages()->default() instead
      */
     public function lang(): ?string
     {
diff --git a/formwork/Utils/FileSystem.php b/formwork/Utils/FileSystem.php
index a79a544b..3d7e0523 100644
--- a/formwork/Utils/FileSystem.php
+++ b/formwork/Utils/FileSystem.php
@@ -489,8 +489,7 @@ class FileSystem
     /**
      * Alias of createFile method
      *
-     * @deprecated
-     * @see FileSystem::createFile()
+     * @deprecated Use FileSystem::createFile() instead
      */
     public static function create(string $file): bool
     {
@@ -501,7 +500,7 @@ class FileSystem
     /**
      * Return a path with a single trailing slash
      *
-     * @deprecated
+     * @deprecated Use FileSystem::normalizePath($path . DS) instead
      */
     public static function normalize(string $path): string
     {
@@ -528,7 +527,7 @@ class FileSystem
     /**
      * Scan a path for files and directories
      *
-     * @deprecated
+     * @deprecated Use generator-based FileSystem::listContents() instead
      *
      * @param bool $all Whether to return only visible or all files
      */
@@ -553,7 +552,7 @@ class FileSystem
     /**
      * Recursively scan a path for files and directories
      *
-     * @deprecated
+     * @deprecated Use generator-based FileSystem::listRecursive() instead
      *
      * @param bool $all Whether to return only visible or all files
      */
diff --git a/formwork/Utils/Uri.php b/formwork/Utils/Uri.php
index 729469ad..4b4650c1 100644
--- a/formwork/Utils/Uri.php
+++ b/formwork/Utils/Uri.php
@@ -271,7 +271,7 @@ class Uri
     /**
      * Resolve a relative URI against current or a given base URI
      *
-     * @deprecated
+     * @deprecated Use Uri::resolveRelativeUri() instead
      */
     public static function resolveRelativeUri(string $uri, string $base = null): string
     {