From 418defb7c5673e07e9056b0b0aef6f73a32804c6 Mon Sep 17 00:00:00 2001 From: Laurie Merrell Date: Wed, 27 May 2026 10:49:17 -0500 Subject: [PATCH 1/5] docs: stub getting started page --- docs/getting-started.md | 69 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 docs/getting-started.md diff --git a/docs/getting-started.md b/docs/getting-started.md new file mode 100644 index 00000000..a80babe6 --- /dev/null +++ b/docs/getting-started.md @@ -0,0 +1,69 @@ +# Meta + +* Add a link to this page to the homepage of [tides-transit.org](http://tides-transit.org) +* Possibly this becomes two pages, one for strategic direction, one for technical implementation + +# Content + +## Getting Started + +If you are interested in adopting TIDES at your transit agency or other organization, this page can help you get started. + +## For leaders and executives + +If you are a leader at an organization and you want your staff to start working on a TIDES adoption project, you will want to identify: + +* **How TIDES aligns with your organization’s strategic priorities or initiatives** + + TIDES can help with a variety of different use cases, from laying the foundation for a data warehouse to streamlining NTD reporting to preparing for an operational system migration. Which use case is most important for your organization? This will help set the technical direction and success criteria. + +* **Technical feasibility** + + A technical subject matter expert (someone with familiarity with operational data and/or analytics at your organization) can review the section below (“For technical staff”) to assess your organization’s technical readiness and approach. + +* **Resourcing** + + Once you have a sense for the technical feasibility, you can determine the right implementation pathway for your organization, whether that be procurement requirements for vendors, in-house work, consultant support, or a mix. + +## For technical staff + +If you are a technical staff member getting started on a TIDES implementation, you will need the following: + +* **Requirements for your use case (information gathered from your stakeholders)** + + What do you need TIDES to do? The specific TIDES data that you need to produce and the format that it takes should be dictated by the use case. “Adopting TIDES” does not have to mean producing every single TIDES table at the same time. For example, NTD ridership reporting might dictate a different approach than a stop-level on-time performance dashboard. + + Example requirements to consider: + * Data scope and features (what TIDES tables to produce and what type of analysis or reporting they need to support) + * Data format / access (how will the TIDES data be accessed by the downstream user(s)) + * Update frequency + * Alignment with other technical initiatives (for example, will this TIDES-based approach replace an existing workflow, or produce something net-new? Are new data tools being deployed at your organization that can be leveraged?) + * Cybersecurity or compliance (does the TIDES data you will produce contain any data that is considered PII or otherwise sensitive according to your organization’s policies? If so, what are the requirements for working with that data?) + + + +* **Assess technical infrastructure** + + Adopting TIDES does not require any specific tools or technologies, but it does require the technical capacity to ingest data, store it, transform it, and serve it to downstream systems (e.g., a business intelligence tool). + + Organizations can ingest, produce, or save TIDES in existing data infrastructure, or pair TIDES adoption with the deployment of new infrastructure and tools, depending on their needs and goals. + + The TRB 2026 presentation \[Name\] outlined a Common Framework and Maturity Ladder for TIDES-related data infrastructure. The deck is available \[here, add link\] and can provide a starting point. + +* **Assess source data availability** + + TIDES is a data format and to leverage it you will need access to the underlying data types: passenger counts, vehicle locations, or fare transactions. + + Once you have identified what TIDES table(s) are needed for your use case, you will need to ensure that you have access to the relevant source data, and that it meets your needs: + + * Does the source provide the core columns for the TIDES table(s) you want to produce? Compare the source data columns with the TIDES table documentation and ensure it provides the required attributes. + + * Do you have access to the location where the data is stored, and can you transfer it to the data environment where you will be working with it? + + * Does the data update at the required frequency, and does your data infrastructure support the necessary update frequency? + +* **Resourcing requirements** + + Each organization will have a different approach to resourcing their TIDES initiatives. The previous requirements-gathering steps should clarify the scope of work to be done, and can then inform how that work can be performed, whether that be in-house, change or task orders to existing vendors, securing consultant support, or some combination. + + \ No newline at end of file From 511f4aa93b58b86634f3ed741916b7b4c19e56b0 Mon Sep 17 00:00:00 2001 From: Laurie Merrell Date: Wed, 27 May 2026 10:59:58 -0500 Subject: [PATCH 2/5] docs: add getting started to nav bar --- mkdocs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/mkdocs.yml b/mkdocs.yml index 1de1b810..9af4fa99 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -86,6 +86,7 @@ nav: - Architecture: architecture.md - Table Schemas: tables.md - Data Package: datapackage.md + - Getting Started: getting-started.md - Sample Data: samples.md - Contributing: - Development: development.md From 7a02b243995580cd8e9b7aa0fd7317825a3df525 Mon Sep 17 00:00:00 2001 From: Laurie Merrell Date: Wed, 27 May 2026 11:47:51 -0500 Subject: [PATCH 3/5] docs: getting started page formatting after previewing locally --- docs/getting-started.md | 69 ++++++++++++----------------------------- 1 file changed, 20 insertions(+), 49 deletions(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index a80babe6..08079001 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -1,11 +1,4 @@ -# Meta - -* Add a link to this page to the homepage of [tides-transit.org](http://tides-transit.org) -* Possibly this becomes two pages, one for strategic direction, one for technical implementation - -# Content - -## Getting Started +# Getting Started If you are interested in adopting TIDES at your transit agency or other organization, this page can help you get started. @@ -13,57 +6,35 @@ If you are interested in adopting TIDES at your transit agency or other organiza If you are a leader at an organization and you want your staff to start working on a TIDES adoption project, you will want to identify: -* **How TIDES aligns with your organization’s strategic priorities or initiatives** - - TIDES can help with a variety of different use cases, from laying the foundation for a data warehouse to streamlining NTD reporting to preparing for an operational system migration. Which use case is most important for your organization? This will help set the technical direction and success criteria. - -* **Technical feasibility** +* **How TIDES aligns with your organization’s strategic priorities or initiatives**
+ TIDES can help with a variety of different use cases, from laying the foundation for a data warehouse to streamlining NTD reporting to preparing for an operational system migration. Which use case is most important for your organization? This will help set the technical direction and success criteria. +* **Technical feasibility**
A technical subject matter expert (someone with familiarity with operational data and/or analytics at your organization) can review the section below (“For technical staff”) to assess your organization’s technical readiness and approach. -* **Resourcing** - +* **Resourcing**
Once you have a sense for the technical feasibility, you can determine the right implementation pathway for your organization, whether that be procurement requirements for vendors, in-house work, consultant support, or a mix. ## For technical staff If you are a technical staff member getting started on a TIDES implementation, you will need the following: -* **Requirements for your use case (information gathered from your stakeholders)** - - What do you need TIDES to do? The specific TIDES data that you need to produce and the format that it takes should be dictated by the use case. “Adopting TIDES” does not have to mean producing every single TIDES table at the same time. For example, NTD ridership reporting might dictate a different approach than a stop-level on-time performance dashboard. - - Example requirements to consider: - * Data scope and features (what TIDES tables to produce and what type of analysis or reporting they need to support) - * Data format / access (how will the TIDES data be accessed by the downstream user(s)) - * Update frequency - * Alignment with other technical initiatives (for example, will this TIDES-based approach replace an existing workflow, or produce something net-new? Are new data tools being deployed at your organization that can be leveraged?) - * Cybersecurity or compliance (does the TIDES data you will produce contain any data that is considered PII or otherwise sensitive according to your organization’s policies? If so, what are the requirements for working with that data?) - - - -* **Assess technical infrastructure** +* **Requirements for your use case (information gathered from your stakeholders)**
+ What do you need TIDES to do? The specific TIDES data that you need to produce and the format that it takes should be dictated by the use case. “Adopting TIDES” does not have to mean producing every single TIDES table at the same time. For example, NTD ridership reporting might dictate a different approach than a stop-level on-time performance dashboard. Example requirements to consider: + * Data scope and features (what TIDES tables to produce and what type of analysis or reporting they need to support) + * Data format / access (how will the TIDES data be accessed by the downstream user(s)) + * Update frequency + * Alignment with other technical initiatives (for example, will this TIDES-based approach replace an existing workflow, or produce something net-new? Are new data tools being deployed at your organization that can be leveraged?) + * Cybersecurity and compliance (does the TIDES data you will produce contain any data that is considered PII or otherwise sensitive according to your organization’s policies? If so, what are the requirements for working with that data?) - Adopting TIDES does not require any specific tools or technologies, but it does require the technical capacity to ingest data, store it, transform it, and serve it to downstream systems (e.g., a business intelligence tool). +* **Assess technical infrastructure**
+ Adopting TIDES does not require any specific tools or technologies, but it does require the technical capacity to ingest data, store it, transform it, and serve it to downstream systems (e.g., a business intelligence tool). Organizations can ingest, produce, or save TIDES in existing data infrastructure, or pair TIDES adoption with the deployment of new infrastructure and tools, depending on their needs and goals. The TRB 2026 presentation \[Name\] outlined a Common Framework and Maturity Ladder for TIDES-related data infrastructure. The deck is available \[here, add link\] and can provide a starting point. - Organizations can ingest, produce, or save TIDES in existing data infrastructure, or pair TIDES adoption with the deployment of new infrastructure and tools, depending on their needs and goals. - - The TRB 2026 presentation \[Name\] outlined a Common Framework and Maturity Ladder for TIDES-related data infrastructure. The deck is available \[here, add link\] and can provide a starting point. - -* **Assess source data availability** - - TIDES is a data format and to leverage it you will need access to the underlying data types: passenger counts, vehicle locations, or fare transactions. - - Once you have identified what TIDES table(s) are needed for your use case, you will need to ensure that you have access to the relevant source data, and that it meets your needs: - - * Does the source provide the core columns for the TIDES table(s) you want to produce? Compare the source data columns with the TIDES table documentation and ensure it provides the required attributes. - - * Do you have access to the location where the data is stored, and can you transfer it to the data environment where you will be working with it? - - * Does the data update at the required frequency, and does your data infrastructure support the necessary update frequency? - -* **Resourcing requirements** +* **Assess source data availability**
+ TIDES is a data format and to leverage it you will need access to the underlying data types: passenger counts, vehicle locations, or fare transactions. Once you have identified what TIDES table(s) are needed for your use case, you will need to ensure that you have access to the relevant source data, and that it meets your needs: + * Does the source provide the core columns for the TIDES table(s) you want to produce? Compare the source data columns with the TIDES table documentation and ensure it provides the required attributes. + * Do you have access to the location where the data is stored, and can you transfer it to the data environment where you will be working with it? + * Does the data update at the required frequency, and does your data infrastructure support the necessary update frequency? +* **Resourcing requirements**
Each organization will have a different approach to resourcing their TIDES initiatives. The previous requirements-gathering steps should clarify the scope of work to be done, and can then inform how that work can be performed, whether that be in-house, change or task orders to existing vendors, securing consultant support, or some combination. - - \ No newline at end of file From 908ac374cdecfa6fd04b71f6ab2e1415fd061169 Mon Sep 17 00:00:00 2001 From: Laurie Merrell Date: Fri, 29 May 2026 10:36:20 -0500 Subject: [PATCH 4/5] docs: add rendered version of wmata sdh writeup --- docs/implementations/wmata-sdh.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/implementations/wmata-sdh.md diff --git a/docs/implementations/wmata-sdh.md b/docs/implementations/wmata-sdh.md new file mode 100644 index 00000000..e8c3883a --- /dev/null +++ b/docs/implementations/wmata-sdh.md @@ -0,0 +1 @@ +{% include-markdown "https://raw.githubusercontent.com/TIDES-transit/tides-implementations/refs/heads/main/agencies/wmata/sdh-writeup/wmata-sdh-writeup.md" %} From 67b0e94b8f5a686e41f53601af71fb371f802f6e Mon Sep 17 00:00:00 2001 From: Laurie Merrell Date: Fri, 29 May 2026 13:10:35 -0500 Subject: [PATCH 5/5] docs: add links to resources --- docs/getting-started.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index 08079001..2fe4ff9b 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -7,10 +7,10 @@ If you are interested in adopting TIDES at your transit agency or other organiza If you are a leader at an organization and you want your staff to start working on a TIDES adoption project, you will want to identify: * **How TIDES aligns with your organization’s strategic priorities or initiatives**
- TIDES can help with a variety of different use cases, from laying the foundation for a data warehouse to streamlining NTD reporting to preparing for an operational system migration. Which use case is most important for your organization? This will help set the technical direction and success criteria. + TIDES can help with a variety of different use cases, from laying the foundation for a data warehouse to streamlining NTD reporting to preparing for an operational system migration. Which use case is most important for your organization? This will help set the technical direction and success criteria. For more information on general use cases for TIDES, see the ["TIDES: Transit Data Pipelines, Not Silos"](https://drive.google.com/file/d/1FeTWyRKnuIdj-SwxEiO8-xtUZQ_E0XzD/view) presentation. For more details on selected use cases, see [TIDES use case profiles](resources.md#use-case-profiles). * **Technical feasibility**
- A technical subject matter expert (someone with familiarity with operational data and/or analytics at your organization) can review the section below (“For technical staff”) to assess your organization’s technical readiness and approach. + A technical subject matter expert (someone with familiarity with operational data and/or analytics at your organization) can review [the section below](#for-technical-staff) to assess your organization’s technical readiness and approach. * **Resourcing**
Once you have a sense for the technical feasibility, you can determine the right implementation pathway for your organization, whether that be procurement requirements for vendors, in-house work, consultant support, or a mix. @@ -20,19 +20,19 @@ If you are a leader at an organization and you want your staff to start working If you are a technical staff member getting started on a TIDES implementation, you will need the following: * **Requirements for your use case (information gathered from your stakeholders)**
- What do you need TIDES to do? The specific TIDES data that you need to produce and the format that it takes should be dictated by the use case. “Adopting TIDES” does not have to mean producing every single TIDES table at the same time. For example, NTD ridership reporting might dictate a different approach than a stop-level on-time performance dashboard. Example requirements to consider: + What do you need TIDES to do? The specific TIDES data that you need to produce and the format that it takes should be dictated by the use case. “Adopting TIDES” does not have to mean producing every single TIDES table at the same time. For example, NTD ridership reporting might dictate a different approach than a stop-level on-time performance dashboard. For more information on selected use cases, see [TIDES use case profiles](resources.md#use-case-profiles). Example requirements to consider: * Data scope and features (what TIDES tables to produce and what type of analysis or reporting they need to support) - * Data format / access (how will the TIDES data be accessed by the downstream user(s)) + * Data format / access (how will the TIDES data be accessed by the downstream users?) * Update frequency * Alignment with other technical initiatives (for example, will this TIDES-based approach replace an existing workflow, or produce something net-new? Are new data tools being deployed at your organization that can be leveraged?) * Cybersecurity and compliance (does the TIDES data you will produce contain any data that is considered PII or otherwise sensitive according to your organization’s policies? If so, what are the requirements for working with that data?) * **Assess technical infrastructure**
- Adopting TIDES does not require any specific tools or technologies, but it does require the technical capacity to ingest data, store it, transform it, and serve it to downstream systems (e.g., a business intelligence tool). Organizations can ingest, produce, or save TIDES in existing data infrastructure, or pair TIDES adoption with the deployment of new infrastructure and tools, depending on their needs and goals. The TRB 2026 presentation \[Name\] outlined a Common Framework and Maturity Ladder for TIDES-related data infrastructure. The deck is available \[here, add link\] and can provide a starting point. + Adopting TIDES does not require any specific tools or technologies, but it does require the technical capacity to ingest data, store it, transform it, and serve it to downstream systems (e.g., a business intelligence tool). Organizations can ingest, produce, or save TIDES in existing data infrastructure, or pair TIDES adoption with the deployment of new infrastructure and tools, depending on their needs and goals. For information on technical architecture considerations associated with TIDES, see [Implementation & Technical Architecture Guidance](resources.md#implementation-technical-architecture-guidance). For example code from other implementations, see [Implementation & Code Examples](resources.md#implementation-and-code-examples). * **Assess source data availability**
- TIDES is a data format and to leverage it you will need access to the underlying data types: passenger counts, vehicle locations, or fare transactions. Once you have identified what TIDES table(s) are needed for your use case, you will need to ensure that you have access to the relevant source data, and that it meets your needs: - * Does the source provide the core columns for the TIDES table(s) you want to produce? Compare the source data columns with the TIDES table documentation and ensure it provides the required attributes. + TIDES is a data format and to leverage it you will need access to the underlying data types from operational source systems: passenger counts, vehicle locations, or fare transactions. Once you have identified what TIDES table(s) are needed for your use case, you will need to ensure that you have access to the relevant source data, and that it meets your needs: + * Does the source provide the core columns for the TIDES table(s) you want to produce? Compare the source data columns with the [TIDES table documentation](architecture.md#files-in-specification) and ensure it provides the required attributes. * Do you have access to the location where the data is stored, and can you transfer it to the data environment where you will be working with it? * Does the data update at the required frequency, and does your data infrastructure support the necessary update frequency?