> The biggest documentation failure I typically have seen in Forth is a failure to document the word's parameters, i.e. the stack contents going into and return

> The biggest documentation failure I typically have seen in Forth is a failure to document the word's parameters, i.e. the stack contents going into and returning from words. This is one reason that the Forth-like Factor language makes documentation of a word's stack-effect a required part of the syntax of defining a word. I believe these days Factor checks for stack-overflow and -underflow at compile-time, based on the stack-effect declarations.