What's in a good specification

• it should explain the use case: why we need this new feature
• describe all changes in server behavior: new administrative console commands, new binary protocol requests, command line options, Lua bindings
• same applies to changes to existing commands, requests, options.