diff --git a/lib/resource-1.0/doc/paradigms.txt b/lib/resource-1.0/doc/paradigms.txt
new file mode 100644
index 000000000..9e7988b1c
--- /dev/null
+++ b/lib/resource-1.0/doc/paradigms.txt
@@ -0,0 +1,28 @@
+Morphological Paradigms in the GF Resource Grammar Library
+Aarne Ranta
+
+
+This is a synopsis of the main morphological paradigms for 
+nouns (``N``), adjectives (``A``), and verbs (``V``).
+
+
+=English=
+
+```
+  mkN : (flash : Str) -> N ;                 -- car, bus, ax, hero, fly, boy
+  mkN : (man,men : Str) -> N ;               -- index, indices
+  mkN : (man,men,man's,men's : Str) -> N ; 
+  mkN : Str -> N -> N ;                      -- baby boom
+
+  mkA : (happy : Str) -> A ;                 -- small, happy, free
+  mkA : (fat,fatter : Str) -> A ;
+  mkA : (good,better,best,well : Str) -> A 
+  compoundA : A -> A ;                       -- -/more/most ridiculous
+
+  mkV : (cry : Str) -> V ;                   -- call, kiss, echo, cry, pray
+  mkV : (stop,stopped : Str) -> V ;
+  mkV : (drink,drank,drunk  : Str) -> V ;
+  mkV : (run,ran,run,running  : Str) -> V ;
+  mkV : (go,goes,went,gone,going : Str) -> V
+```
+
diff --git a/lib/resource-1.0/english/ParadigmsEng.gf b/lib/resource-1.0/english/ParadigmsEng.gf
index ea90ac3e1..6cebee6d8 100644
--- a/lib/resource-1.0/english/ParadigmsEng.gf
+++ b/lib/resource-1.0/english/ParadigmsEng.gf
@@ -67,25 +67,19 @@ oper
 
   mkN : overload {
 
--- Worst case: give all four forms.
-
-    mkN : (man,men,man's,men's : Str) -> N ;
-
 -- The regular function captures the variants for nouns ending with
 -- "s","sh","x","z" or "y": "kiss - kisses", "flash - flashes"; 
 -- "fly - flies" (but "toy - toys"),
 
     mkN : (flash : Str) -> N ;
 
--- In practice the worst case is just: give singular and plural nominative.
+-- In practice the worst case is to give singular and plural nominative.
 
     mkN : (man,men : Str) -> N ;
 
--- All nouns created by the previous functions are marked as
--- $nonhuman$. If you want a $human$ noun, wrap it with the following
--- function:
+-- The theoretical worst case: give all four forms.
 
-    mkN : Gender -> N -> N ;
+    mkN : (man,men,man's,men's : Str) -> N ;
 
 --3 Compound nouns 
 --