Skip to content

Latest commit

 

History

History
140 lines (117 loc) · 24.5 KB

README.md

File metadata and controls

140 lines (117 loc) · 24.5 KB

Welcome to Civiwiki

ComVer Maintainability

We are an open source, non-profit community, working to develop a democratic engagement web system.

Why CiviWiki?

  • Democratically Contributed Media. As the name CiviWiki implies, our core content will be contributed by volunteers on our Wiki. Our topic format is modular. The structure allows both a community of volunteers to collaborate on a single political issue, and reserves space for dissenting opinions.
  • Personalized Policy Feed. CiviWiki intelligently personalizes users' feed in two meaningful ways. First, the issues promoted to users' feed will be personalized to the user's expressed interests, and the timeliness of the issue. Second, the structure of the issue topics break policy positions into bite-sized contentions we call Civies. Each Civi is logically related to the rest of the topic. Based on the user's support, opposition, or neutrality to each Civi, CiviWiki promotes different relevant content.
  • Citizen/Representative Engagement. CiviWiki's core goal is to engage citizens and their representatives, with the goal of making government more accountable. CiviWiki will achieve this goal in two ways. First, CiviWiki will organize user's policy profile and compare it to every political candidate in the user's district. This quick, detailed, comparison will help users make informed votes, and we believe increased voter confidence will increase voter turnout. Second, CiviWiki will collect anonymized user data and forward district level statistics to representatives. With a critical mass of users, we believe timely district level polling data will influence representatives' votes.

Requirements

To install all required modules, complete the following steps:

  1. make sure you are in the repository root directory
  2. create a Python 3.7+ virtual environment (named env)
    • python -m venv env
  3. use the following command in project dir:
    • pip install -r requirements.txt

Or, if you prefer, you can use Docker compose:

docker-compose up

Contact info

Contact us on Twitter to join the team.

Join us on the following channels:

Contribute

See our Contributing Guide for instructions on how to contribute code.

Contributors

Thanks goes to these wonderful people (emoji key):


Mitchell D. West

💻 🐛 💼 💵 🔍 🤔 📆 👀

Tomasz Kolek

💻 ⚠️ 🛡️ 👀

Petar Petrov

⚠️

Petar Petrov

⚠️

Steven Hitchcock

💻

Ryan Barrett

💻

WCollins3

💻

JooHee Lee

💻 🐛 📖 🤔 🚇 💬

delta-plus

💻 🐛 📖 🤔 💬

Gordon Stangler

💻 🐛 🤔

Brylie Christopher Oxley

💻 🐛 📆 👀 📖 🚇 🚧

Dan Borstelmann

💻 🐛 🚇 🤔

Darius Calliet

💻 🐛 🤔

Trac Taylor

💻 🐛 🤔

Tom John Hall

💻

Jake Strang

💻

Daniel Grijalva

💻

Gustavo

💻

Paul Scheid

💻 🤔 💬

terrencetuy

💻

Jon Ander Oribe

💻 🐛

Shaunak

💻

Daniel Larner

💻

Darcy Meyer

💻

Javier Martínez

💻

Rohit Ramesh

💻

richifuentes

🐛 💬 🤔

Alec Sears

🐛

Shrys

🤔 🐛

Xin Tan

📓

jgbmattos

📓

Torab Shaikh

💻

Caio Shimada Rabello

💻

UMAIR MOHAMMAD

💻

Hush

💻 📖

JDRanpariya

📖 💻

Di-ref

💻

Brian Painter

💻

Ankan Das

📖

gteti

📖

Harsha Vardhan

💻

Obafemi Joseph Olorungbon

💻

tberm

💻

Anthony B.

💻

Md. Fardeen Ehsan Shawon

📖

Ikko Ashimine

💻

Abhi

💻

Jacob North

💻

Loukik Bhangale

💻

Swanand01

💻

Ahmed Nassar

💻

Jithen Shriyan

💻

Shourya Shikhar

📖

max1204

💻

Soumallya Dev

💻

Stanley Ndagi

📖

Shashank KS

💻

Jourdon Floyd

📖

This project follows the all-contributors specification. Contributions of any kind welcome!

Testing

See our Testing Guide for instructions on how to test code.