Skip to content
A game of guessing political party manifestos as an experiment in UK political understanding.
Python HTML CSS Mako
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
migrations
static
templates
Procfile
README.md
app.py
config.py
manage.py
models.py
requirements.txt
runtime.txt

README.md

ManifestWho?

A game of guessing UK political party manifestos: manifestwho.com.

Manifestwho is a quiz about UK political manifestos. It's mainly supposed to be fun (for a niche, political kind of fun). It's also a little experiment into how well people can recognise messages from manifestos - we've got a suspicion it's quite hard.

Built in Python using Flask and a Postgres database. Deployed on Heroku at manifestwho.com. Contributions are very welcome (more details below).

EU Election 2019 Manifesto reference

European Election 2019 manifestos used to source quotations, in alphabetical order:

Read more about manifesto inclusion choices in the FAQ.

Contributing to ManifestWho?

If you'd like to make a change or improvement via GitHub, you can fork the repository and make a pull request using these steps:

  1. Click 'fork' at the top of this repository
  2. Clone down your fork using git clone https://github.com/YOUR-USERNAME/manifestwho
  3. Create a new branch with the name of the meetup you're adding
  4. Make your change
  5. Push your new branch and changes up to your fork of the repository
  6. Go to your branch in your repository on GitHub, and click the green 'New pull request' button on the left (making sure the base fork is set to JennyBrennan/manifestwho)
  7. If I've not got back to you about your PR in a resonable time, feel free to nudge me on Twitter @jennyhbren

Related reading

Running locally

From within the manifestwho folder, start the virtual environment:

. venv/bin/activate

You'll need to set environment variables for APP_SETTINGS and DATABASE_URL, either via the terminal or a .env file:

export APP_SETTINGS="config.DevelopmentConfig"
export DATABASE_URL="postgresql://localhost/manifestwho"

Run the app:

python3 app.py

TODOs

A few things I'd like to tackle in the future (particularly before any future election):

  • Update with new manifestos, come the next UK General Election (which could be at any time!) - possibly version it to allow people to still play the EU 2019 elections version.
  • Automate testing - at the moment I'm manually testing the app as I chucked it up pretty quickly as a proof of concept; would be better to have tests that mock postgres and/or run end-to-end UI tests with Selenium or similar.
  • Add web analytics to monitor where participants are based and where referrals are coming from (e.g. if all participants were in the US, then the data won't tell us much about UK public understanding).
  • Consider additional voluntary data collection at the end e.g. voting intention. Look into the best ways of phrasing these from existing research.
  • A sharing/social media plan to get the word out and increase participation.
  • Design a swanky logo and add favicon.

There's also likely a bunch of general tidying/improvement that could be done in the code - I'm new to this stack (beyond teaching the Code First Girls Python Course) and picked it as a quick learning opportunity, so suggestions welcome!

You can’t perform that action at this time.