diff --git a/paper-api/src/main/java/org/bukkit/entity/Villager.java b/paper-api/src/main/java/org/bukkit/entity/Villager.java
index 069c8435b6..6d62079dea 100644
--- a/paper-api/src/main/java/org/bukkit/entity/Villager.java
+++ b/paper-api/src/main/java/org/bukkit/entity/Villager.java
@@ -72,7 +72,7 @@ public interface Villager extends Ageable, NPC, InventoryHolder {
      * Note that this inventory is not the Merchant inventory, rather, it is the
      * items that a villager might have collected (from harvesting crops, etc.)
      *
-     * @inheritDoc
+     * {@inheritDoc}
      */
     @Override
     Inventory getInventory();
diff --git a/paper-api/src/main/java/org/bukkit/inventory/meta/PotionMeta.java b/paper-api/src/main/java/org/bukkit/inventory/meta/PotionMeta.java
index 1ebf066e02..2be09e2efa 100644
--- a/paper-api/src/main/java/org/bukkit/inventory/meta/PotionMeta.java
+++ b/paper-api/src/main/java/org/bukkit/inventory/meta/PotionMeta.java
@@ -77,7 +77,7 @@ public interface PotionMeta extends ItemMeta {
      *
      * @param type the potion effect type to move
      * @return true if the potion meta changed as a result of this call
-     * @deprecated use {@link #setType(PotionType)}
+     * @deprecated use {@link org.bukkit.potion.PotionType#PotionType}
      */
     @Deprecated
     boolean setMainEffect(PotionEffectType type);
diff --git a/paper-api/src/main/java/org/bukkit/potion/Potion.java b/paper-api/src/main/java/org/bukkit/potion/Potion.java
index d800f7f114..28d24f6b46 100644
--- a/paper-api/src/main/java/org/bukkit/potion/Potion.java
+++ b/paper-api/src/main/java/org/bukkit/potion/Potion.java
@@ -105,7 +105,7 @@ public class Potion {
     }
 
     /**
-     * @Deprecated
+     * @deprecated
      */
     @Deprecated
     public Potion(int name) {