diff --git a/src/Models/FileLink.php b/src/Models/FileLink.php
index 15c7779e..f604c477 100644
--- a/src/Models/FileLink.php
+++ b/src/Models/FileLink.php
@@ -5,6 +5,12 @@
 use SilverStripe\Assets\File;
 use SilverStripe\Forms\FieldList;
 
+/**
+ * A link to a File in the CMS
+ *
+ * @property int $FileID
+ * @method File File()
+ */
 class FileLink extends Link
 {
     private static string $table_name = 'LinkField_FileLink';
diff --git a/src/Models/Link.php b/src/Models/Link.php
index 78e9cb55..0ccefd9e 100644
--- a/src/Models/Link.php
+++ b/src/Models/Link.php
@@ -15,7 +15,7 @@
 use SilverStripe\ORM\FieldType\DBHTMLText;
 
 /**
- * A Link Data Object. This class should be a subclass, and you should never directly interact with a plain Link
+ * A Link Data Object. This class should be treated as abstract. You should never directly interact with a plain Link
  * instance
  *
  * @property string $Title