Divided into declarative and imperative demos
Improved documentation and linting
Typo
Merge pull request #16 from Financial-Times/demo-fixes

Demo and readme fixes and linting