add verbose mode, limitations section and more bugs