Simple, extendable, voice interaction with parliamentary data.

Alexa Parliament Skill is a Node.js application created by the Parliamentary Digital Service that allows Alexa-enabled devices to communicate parliamentary data to it's users through a VUI (Voice User Interface).

Contents

• Technical Documentation
  • Technical Overview
  • Command Flowchart
  • Presentations
• Development
  • Requirements
  • Getting Started with Development
  • Running the tests
• Contributing
• License

Technical Documentation

Technical Overview

The technical overview covers how the skill itself functions. A user speaks a voice command, this triggers the AWS Lambda function running this node application, and the application contacts the parliamentary calendar.

Command Flowchart

The flowchart documents the flow of our skill, showing the user inputs, internal decisions, and eventual outputs.

Presentations

Date	Name	PDF
2017-05-16	Digital Team Meeting at PDS	PDF

Development

Requirements

Alexa Parliament requires the following:

• Node.js - click here for the exact version
• npm

Getting Started with Development

To clone the repository and set up the dependencies, run the following:

git clone https://github.com/mattrayner/alexa-parliament.git
cd alexa-parliament
npm install

Running the tests

We use Mocha and Chai (among others) for testing. The tests can be run using:

npm test

Contributing

If you wish to submit a bug fix or feature, you can create a pull request and it will be merged pending a code review.

1. Fork the repository
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Ensure your changes are tested using [Rspec][rspec]
6. Create a new Pull Request

License

Alexa Parliament Skill is licensed under the MIT license.