cal-itp / data-playbook Goto Github PK

As a transit agency staff, it is often easy for me to send or receive full documents as sources; as such, I'd like to be able to have access to a fully-rendered booklet to keep on my desk (virtual or not)

!!! note
User research needed to confirm this is a need

Process checklist

• scope refinement/stakeholder research
• outline / review
• content research + dev’t
• content draft / review
• final draft / PR on github

Responsibilties

Author: @e-lo
Supported by:
Reviewers:
Approver:

User Stories

As a playbook reader I'd like to understand who the intended audience is and how best to use the playbook when I first visit the site.

Specific users

• list of individuals or organizations who have expressed this as a need

Areas to address

• audience.
• organization

Information sources

• who should we talk to

Draft development document

User Stories

As a transit provider who wants to make sure my fares are in trip planners I'd like to understand what I need to do in order to fit it into my work plan (LOE/needs) and what I need to actually do.

Specific users

• Henry in the future
• Agencies who might be interested and want to know LOE

Areas to address

• Mechanism for transmitting fares data to customers in trip planners (Fares v2)
• What information is currently supported (and by which products)
• Creating Data: Steps to create fares data // lessons learned // best practices // make sure it is correct -- what help is available?
• Getting Data into GTFS: self publication // vendors -- what help is available?

Information sources

• Ruth's materials she developed for DRMT
• Chris's best practices/lessons learned

Content Development Document

Process checklist

• scope refinement/stakeholder research
• outline / review
• content research + dev’t
• content draft / review
• final draft / PR on GitHub

Responsibilities

Author: @e-lo
Supported by: @mcplanner
Reviewers: Chris Erickson, Henry
Approver: @julieteldred

Process checklist

• scope refinement/stakeholder research
• outline / review
• content research + dev’t
• content draft / review
• final draft / PR on github

Responsibilties

Author: @e-lo
Supported by: @mcplanner
Reviewers: Weston, Scott F
Approver: @julieteldred

User Stories

As a transit provider with flexible or demand-responsive services, I'd like to understand how to get my service accurately reflected in trip planners

Specific users

• list of individuals or organizations who have expressed this as a need

Areas to address

• important things
• that this topic request should include

Information sources

• who should we talk to

Working Content Document

1. Review notes from transit stack interviews
2. Talk to Danielle and Evan
3. Document as a new Topic Issue

User Stories

As a playbook user, I'd like to understand how the content for the playbook was developed and researched.

As a writer (volunteer or otherwise) for the playbook, I'd like to understand the expectations and process for contributing content.

Specific users

• tktk

Areas to address

• Overall process and roles
• Stakeholder interviews and raw content documentation
• Information sources
• Editorial process
• ....?

Information sources

• who should we talk to

Draft Content Document

Process checklist

• scope refinement/stakeholder research
• outline / review
• content research + dev’t
• content draft / review
• final draft / PR on github

Responsibilties

Author:
Supported by:
Reviewers:
Approver:

User Stories

As a [audience for information] I'd like to understand [desired knowledge] in order to [something important]

Specific users

• list of individuals or organizations who have expressed this as a need

Areas to address

• important things
• that this topic request should include

Information sources

• who should we talk to

User Stories

As a transit agency CTO/CIO I'd like to understand what the recommended technology stack would be to meet my agencies needs in an efficient and resilient manner.

Specific users

• list of individuals or organizations who have expressed this as a need

Areas to address

• important things
• that this topic request should include

Information sources

• who should we talk to

Process checklist

• scope refinement/stakeholder research
• outline / review
• content research + dev’t
• content draft / review
• final draft / PR on github

Responsibilities

Author: @e-lo
Supported by: @mcplanner , ...?
Reviewers: Weston, Mobility Data?, Taskar?
Approver: @julieteldred

User Stories

As a transit agency maintenance staff I'd like to understand critical accessibility infrastructure in my network in order to prioritize up time and maintenance.

As a transit agency planning staff I'd like to understand what missing infrastructure would contribute the most to an equitably accessible transit system.

As an advocate, I'd like to be able to effectively advocate for the above.

As a transit rider with a mobility device, I'd like to definitively know if an accessible transit route is available for a specific journey and specific instructions or requirements which I must follow or be aware of.

Specific users

• LAMTA.

Areas to address

Network data checklists and quality assessments:

• GTFS-Pathways.
• GTFS wheelchair boarding.
• GTFS Flex.
• GTFS capabilities.
• OSM Open Sidewalks

Analysis methods + tools:

• Conveyal?
• OSMNX. (maybe an example notebook?)

Journey Planning:

• Access map?
• Google maps???
• other?

Information sources

• Agencies who are interested in doing this type of analysis for Title VI other purposes.
• Agencies who want to make sure they publish the right data (i.e. LAMTA).
• Agencies already publishing a lot of accessibility data.
• Taskar Center.
• Other?

content development document

Process checklist

• scope refinement/stakeholder research
• outline / review
• content research + dev’t
• content draft / review
• final draft / PR on github

Responsibilties

Author: @julieteldred
Supported by:
Reviewers: @e-lo
Approver: @e-lo

User Stories

Transit agency has generated GTFS data, or receives data from a vendor. They provide an official URL at which to download data, with an information page, terms, and license.

Specific users

• Transit agency staff
• Regional planning organization

Areas to address

• How to publicize
• Meta information to include

Information sources

• Web-developer
• tranist.land people (directories)

Process checklist

• scope refinement/stakeholder research
• outline / review
• content research + dev’t
• content draft / review
• final draft / PR on github

Responsibilties

Author: @julieteldred
Supported by: @e-lo
Reviewers:
Approver: @e-lo

User Stories

As a transit agency staff I'd like to understand what various pieces of transit technology are and how they work in order to correctly plan, procure, and manage the overall transit technology system.

As a transit technology vendor I'd like to understand the basic requirements for my product and where and how it should plug into an overall transit technology "stack."

Specific users

• list of individuals or organizations who have expressed this as a need

Areas to address

For each component:

• purpose and need.
• typical functions.
• attributes.
• externally accessible interactions and methods.
• examples, including how it might relate to other members of a transit technology stack

Information sources

• transit stack interview report
• vendors for each component to help self-define (while doing this, please update the products list)
• FDOT Transit Technology Primer

Content Development Document

In order to look like a trusted source, the playbook needs a logo and a graphic identity.

User stories

As a transit provider staff person responsible for realtime customer information, I'd like to provide guidance to my management about how to improve our GTFS-Realtime Uptime

As a transit technology company assisting a transit provider with GTFS Realtime, I'd like to provide guidance to my client about how to improve GTFS-Realtime uptime as well as address whatever strategies I can within my own products

Areas to address

Information sources

• - MetroTransit
• - MBTA
• - LA Metro
• - SFMTA
• - Swiftly
• - GMV Synchromatics
• ....