CouncilDataProject / CouncilDataProject/cdp-frontend

Council Jargon Hints

Open
#83 8 comments 2 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
17
Forks
28
PR merge metrics
No merged PRs in 30d

Description

## Idea / Feature

The idea would be to create some sort of council action glossary and associated UI to give contextual/relevant hints to that jargon.

When any jargon is used (i.e. “voted out of committee”) there should be some UI/hints that explain what the jargon means in a human-readable way.

## Use Case / User Story

As a local citizen who is not as well versed in local politics, I want to be able to understand city council jargon so that I can gain a better grasp of the implications and consequences of council actions/discussions.

## Other Notes

I think the big crux of this idea is that it _should not_ just be a static glossary that someone has to cross-reference while engaging in CDP material––these hints should be timely, relevant, and well-integrated into whatever experience they are in.

Additionally, this functionality/feature should be optional. If there is someone well versed in local politics they should have the ability to turn this off as a setting.

Finally, it's also really important that the glossary of definitions we create are genuinely "human-readable" and should be vetted/tested _at least_ a few times with a wider variety of people. I think a good marker of success is if an elementary school or maybe a middle school-aged child could read/comprehend these definitions.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.