Parliament.uk-utilities

Parliament.uk-utilities is a Rails application designed to hold the utility parts of the new parliament.uk website made by the Parliamentary Digital Service.

Contents

Requirements

Parliament.uk-utilities requires the following:

Getting Started

Clone the repository:

git clone https://github.com/ukparliament/Parliament.uk-utilities.git
cd Parliament.uk-utilities

Utilities Rails Application

The Parliament.uk-utilities application holds the routes, controllers and views that make up all the utility elements of the new parliament.uk website. Utilities include the areas of the website which are not individual items or lists but are standalone endpoints eg. search, postcodes, resources.

Running the application

To run the application locally, run:

bundle install

bundle exec rails s

Running the tests

We use RSpec as our testing framework and tests can be run using:

bundle exec rspec

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
  6. Create a new Pull Request

License

Parliament.uk-utilities is available as open source under the terms of the Open Parliament Licence.