Skip to content

Latest commit

 

History

History
155 lines (118 loc) · 6.34 KB

events-spec.md

File metadata and controls

155 lines (118 loc) · 6.34 KB

Events Calendar

A public calendar of events of potential interest to Democratic party activists, candidates, and elected officials. The calendar may include events from: local Democratic party organizations, candidates, elected officials, and allied organizations.

Contents

Getting Involved

The project maintainers are using a public GitHub repository for data, code, and discussion:

Project Goals

  • Democratic activists, potential activists, candidates, and elected officials can find an upcoming event
  • Democratic activists, party leaders, candidates, elected officials, and staff have a single, central source for events
  • Democratic party organizations, candidates, and elected officials can suggest an event to add

v1.0 Feature Goals

Event display

  • Event title, date, time, location, title
  • Event title hyperlinks to more info about the event

Event submisssion

  • Web form for event submission - DRAFT
  • Basic drop-downs (or validation) for schematized fields like date, time, and LPO

Views

  • Default list of events
  • Mini list of events for embedding in a web widget
  • Full list of events for embedding in a web page
  • Calendar view of events #66

Filters

  • Date
    • All events
    • Upcoming events
    • Past event
  • Organization
    • All orgs
    • Single selected organization #67

Export

  • Add a single event to your calendar #69
    • Google Calendar
    • Microsoft Outlook
    • iPhone calendar
  • Add events from a filtered view to your calendar #70
    • Google Calendar
    • Microsoft Outlook
    • iPhone calendar

vNext Feature Goals

Event display

  • Event organization hyperlinks to that organization if in Orgs JSON

Filters

  • Organization
    • Filtering to a geographic organization (ex: LD or County) includes events within that LD or County #68

Export

  • WordPress plug-in or module for displaying a view on the events calendar #59

Event Listing Policy

Below is a DRAFT event listing policy.
SHOULD, MAY, and SHOULD NOT are intended to have meanings as described in IETF RFC 2119.

These events SHOULD be listed:

  • (Non-recurring) events hosted by local Democratic party organizations
  • (Non-recurring) events for Democratic candidates
  • (Non-recurring) events for Democratic elected officials
  • (Non-recurring) events for non-partisan candidates who are endorsed by a preponderance of local Democratic party organizations
  • (Non-recurring) events for ballot measure positions endorsed by a preponderance of local Democratic party organizations

These events MAY be listed:

  • Recurring events with specific agendas (ex: monthly meeting with a panel, endorsements vote, officer elections, etc.)
  • Recurring events with a special guest (ex: weekly campaign phone bank joined by a special guest)
  • Events for non-partisan candidates who have previously been endorsed by a local Democratic organization but not endorsed this cycle

These events SHOULD NOT be listed:

  • Recurring Democratic organization business meetings or board meetings without agendas specific to that meeting
  • Campaign events for non-partisan candidates who have never been endorsed by a local Democratic organization

Events Data Schema

This section describes the fields in the orgs.json file.

eventDate

(Required) The day and date on which the event takes place. (ex: "Thu, 12/1")

eventStartTime

(Required) The time at which the evnet starts. (ex: "7:00 PM")

eventEndTime

(Optional) The time at which the event ends.

eventOrgShort

(Required) Short name for the organization hosting.
See Orgs Spec

eventOrgType

(Required) A descriptor of the organization type. (ex: "LD", "County", "State", "Ally") See Orgs Spec

eventTitle

(Required) A title for the event.
Please do NOT include the name of the organization hosting the event.

eventLocationName

(Required) Name of the location where the event will be held. (ex: "Yakima County Democrats office", "Mercer Island Community Center", "Home of John Smith")

eventLocationStreet

(Optional) Street address for the event location. (ex: "123 Main St.")

eventLocationCity

(Optional) City for the event location (ex: "Wenatchee")

eventLocationST

(Optional) Two-letter state abberviation for the event location (ex: "WA")

eventLocationZip

(Optional) ZIP code for the event location (ex: "98040")

eventWeb

(Required) Web address where visitors can find more information about this event.

eventFbId

(Optional) Facebook ID for this event (ex: "1811175945791682")

eventDescription

(Optional) Additional details about this event. (ex: "Doors open at 6pm and program starts at 7pm", "Dinner will be served", "Suggested $20 donation")