What's in a good specification - AnaNek/tarantool GitHub Wiki
- 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.