diff --git a/src/Models/FileLink.php b/src/Models/FileLink.php
index 483dd6ee..21b8d832 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 315e08b6..cba2a807 100644
--- a/src/Models/Link.php
+++ b/src/Models/Link.php
@@ -16,7 +16,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