Improve transit database documentation #3774
Open
+50
−21
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
amandaha8
reviewed
Mar 17, 2025
| | <span style="white-space: nowrap;">Area of Focus</span> | How to Identify an `agency` | | ||
| | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ||
| | **Organizations** | Within the [California Transit Base](california-transit), organizations can represent transit agencies or other organizations that don't provide transit service. Some of these entities may "manage" several transit services. Some of these organizations have a built-in crosswalk to NTD data via the `ntd_id_2022` column. | | ||
| | **Services** | Within the [California Transit Base](california-transit), services represent a type of transit "product" that people can use to travel. Services are differentiated if there is a difference in any of the following characteristics: <ol><li>Provider of the service</li><li>"Super-mode" of the service.</li><li>Whether the service is a "fixed-route" service.</li><li>Whether there are different "rider requirements" that passengers must qualify for in order to ride.</li></ol> Often times, organizations (especially large transit agencies) will "manage" multiple services. <br/><br/>**Examples of `services` for OCTA:**<br/><ul><li>`Orange County Transportation Authority`: fixed-route bus service</li><li>`OC Streetcar`: fixed-route streetcar service</li><li>`OC ACCESS`: paratransit demand-response service</li><li>`OC Flex`: a demand-response service open to public</li></ul>| |
There was a problem hiding this comment.
Can you define what super mode means in this context?
amandaha8
reviewed
Mar 17, 2025
|
|
||
| | <span style="white-space: nowrap;">Area of Focus</span> | How to Identify an `agency` | | ||
| | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ||
| | **Organizations** | Within the [California Transit Base](california-transit), organizations can represent transit agencies or other organizations that don't provide transit service. Some of these entities may "manage" several transit services. Some of these organizations have a built-in crosswalk to NTD data via the `ntd_id_2022` column. | |
There was a problem hiding this comment.
Can you give an example of an entity that manages several transit services and an example of an organization that doesn't provide transit service?
|
While we are editing this page can we update the airtable documentation link to WORD DOCUMENT |
ohrite
force-pushed
the
transit-database-docs-update
branch
from
11e9328 to
729174c
Compare
ohrite
force-pushed
the
transit-database-docs-update
branch
from
729174c to
1d990ec
Compare
ohrite
force-pushed
the
transit-database-docs-update
branch
from
1d990ec to
ce985ca
Compare
ohrite
requested review from
charlie-costanzo,
erikamov,
mjumbewu,
ohrite and
themightychris
as code owners
erikamov
force-pushed
the
transit-database-docs-update
branch
from
ce985ca to
e67294e
Compare
ohrite
force-pushed
the
transit-database-docs-update
branch
from
e67294e to
29c9e36
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Following internal discussion, this update tries to add more documentation about the core data model of "organizations", "services", "gtfs service data" and "gtfs datasets".
Type of change
How has this been tested?
Hoping the CI runs pass. 🙏
Post-merge follow-ups