diff --git a/src/game/combat.ts b/src/game/combat.ts
index 348a12b..682c2ba 100644
--- a/src/game/combat.ts
+++ b/src/game/combat.ts
@@ -244,6 +244,9 @@ export class UniformRandomDamageFormula implements DamageFormula {
   }
 }
 
+/**
+ * A [[DamageFormula]] that uses the attacker's stats
+ */
 export class StatDamageFormula implements DamageFormula {
   constructor (private factors: Array<{ stat: Stat|VoreStat; fraction: number; type: DamageType; target: Vigor|Stat }>) {
 
@@ -592,6 +595,7 @@ export class Effective {
     return []
   }
 }
+
 /**
  * A displayable status effect
  */
diff --git a/src/game/combat/perks.ts b/src/game/combat/perks.ts
index 0637eb1..ee7780c 100644
--- a/src/game/combat/perks.ts
+++ b/src/game/combat/perks.ts
@@ -7,6 +7,9 @@ import { DamageConsequence, LogConsequence } from './consequences'
 import { LogLine } from '../interface'
 import * as Words from '../words'
 
+/**
+ * A Perk is like a permanent status effect for a creature.
+ */
 export abstract class Perk extends Effective {
   constructor (public name: TextLike, public desc: TextLike) {
     super()