Giter VIP home page Giter VIP logo

civic-tech-taxonomy's Introduction

civic-tech-taxonomy

Standardized identifiers for categorizing civic technology projects and interests so we can better help people who want to work together find each other across the network

Taxonomy sets needed

  • Technologies Used
  • Topics/Interests
  • Skills Needed
  • Project Roles

Draft User Interface

taxonomy

Project goals

  • Publish via this repository several lists of terms that describe the tools, topics, and techniques of civic technology
  • Establish community standards for the data format, language conventions, and organizational strategies of these taxonomies
  • Provide a user-friendly way to generate a pull request for adding a term
  • Automate as much of the review for pull requests as possible to help things move quickly
  • Automatically publish merged changes in a variety of formats for easy consumptions: plaintext, CSV, YAML, JSON
  • Provide hosted search endpoints with CORS enabled and example implementations of integrated inputs in a variety of html/javascript frameworks

Open questions

  • What sort of hierarchy is needed? Should the taxonomy lists be flat, organized within a single level of categories, or support any level of nesting?
    • Concensus seems to

Use cases

  • Brigades use various CMS tools for keeping track of their projects. The taxonomy could be imported into such a system or a dynamic input field embedded that suggests official topics for end users and moderators categorizing projects
  • A network-wide site could index local projects and take advantage of the official taxonomy to provide a better browsing/search experience
  • Brigade members could set up a profile indicating what topics they're interested in, and be alerted in the future when projects in their interest area(s) are started or have updates

Format

Tags defined within the repository are stored in the gitsheets format, and can be read with any TOML parser or higher-level gitsheets interface.

See project documentation for more information

Related work and reading

civic-tech-taxonomy's People

Contributors

brigade-bot avatar giosce avatar gregboyer avatar k3kaw8pnf7mkmdsmphz27 avatar themightychris avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

civic-tech-taxonomy's Issues

Add `Policing` as an issue?

Based on @rkaufman13's UX interviews, policing seem like it should be in issues.

I'll leave this issue open for anyone to fix, but I'll see if I can figure it out myself otherwise ๐Ÿ˜›

task: dump various tag db's in a common location

I'd love to get more headway on this project worked on. Jaoyi and the User Research team in Code for SF are looking into methods of project matching in partnership with Brigadehub, and standardizing the taxonomy is kind of the first step for that.

I have a list of different tags that have been used by various projects in the C4SF brigadehub instance, and I can get that linked/dumped into this repo for future parsing, I'm wondering if @themightychris has access to some of tags that are being used within Laddr.

Once we've dumped these into a common location, Jaoyi is looking into doing some user research on the parsed list to see if there are any that we've missed or if there are related tags or fields that haven't been listed. With any luck, the user research forms they make can be reused in Philly or any other brigade to get a more global perspective on it.

Taxonomy - Challenge Assumptions

Overview

Do we need Taxonomies? There are several taxonomies. Identify if all are needed for Project Index.

Assumptions

  • We need a taxonomy for the brigades to use for project topics, technologies, skills
  • It is crucial for success that all the brigades that will participate in Project Index will use the same taxonomy.

Action Items

  • Challenge the assumptions by identifying other options
    • Identify pros and cons of other options
  • Define what would be gained by using taxonomies over other options.

Improve Editor

Make drag&drop work properly.
Add mechanism to save as PR to change toml files in the repository.

UI folder

Change name, from editor-ui to ui.
It'll require changes to some deployment scripts.

Swagger

Build and deploy swagger of the API.

Taxonomy - Identify which one(s) to use and their challenges

Overview

Identify most recent and official taxonomies and identify issues of using them inside of Project Index

Action Items:

Review all the Taxonomies identified by CfA and Brigade champions who are working in this area

  • Identify pros and cons of resources
  • Identify challenges in sustainability that might impact Project Index.

Improve UI

mostly cosmetic, css to make it similar to project index.

Phone Screen

The tree shows very little when showing on phone.

Taxonomy - UX talk with project leaders/brigade leaders

Overview

If taxonomies are integral to Project Index then adoption user research is key to planning broad deployment.

Action Items:

Talk with project leads at our brigades and find out:

  • Are they are willing to use a common taxonomy?
  • Do they approve of the current taxonomy or do they have changes to it?
  • How do they want to contribute to an updated Taxonomy?
  • How should we handle updating taxonomy (e.g., updating LGBT to LGBTQ to LGBTQ+ or LGBTQI, etc) after projects have integrated older terminology into whatever data standard Project Index requires?

Integrate Civic Tech Field Guide taxonomy

Pinging @mstem who's been working on the Civic Tech Field Guide for a few years now: https://civictech.guide

This page has some categories that we could consider integrating. We would then be able to contribute our projects back to the civic tech field guide, which would be sweeeeeeeeeet.

This might be a bit challenging:

  • The categories are hierarchical -- do we want to incorporate hierarchy? (My vote: No)
  • Do we need a new top-level concept than "topics" to represent these categories? These groupings in the CTFG feel a bit different than the focus area of the product. But I could see keeping everything as denormalized tags as being beneficial.

Thoughts?

Create a relational database

Create a relational database with a schema allowing to store organizations, projects, tags, topics and their relationships.

UI Page for view only

Right now we only have the editor UI page, we want one just for view the finalized taxonomy.

Use non USA centered item names

1st Amendment and 2nd Amendment are understood only in the USA.
These two should be changed to "Free Speech" and "Gun Violence".
There may be other such items.

Label vs ID

We show the label but we would like to tell people to use the ID.
Labels can have spaces, for example "Benefits and Tax Credits" but that can't be used as a GitHub tag (can't have spaces). In this case, the ID is already set to benefits-taxes. If as one of the first usage of taxonomy is to suggest people how to tag their project, we need to convey that they need to use the ID instead of the label. For items at top level, the ID is shown on mouse-hover, I doubt it is enough and currently the ID doesn't show for lower level items.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.