docs: fix headers to align with epiportal categories in other endpoints and indicate date formats

Author: JavierMtzRdz

docs/api/01meta.md

@@ -18,13 +18,13 @@ General topics not specific to any particular endpoint are discussed in the
 
 ## API Metadata
 
-... <!-- TODO -->
+Overview of the current state of the database, including the latest update times and data volume for specific endpoints.
 
 # The API
 
 The base URL is: <https://api.delphi.cmu.edu/epidata/meta/>
 
-See [this documentation](README.md) for details on specifying epiweeks, dates, and lists.
+See [this documentation](date_formats.html) for details on specifying epiweeks, dates, and lists.
 
 ## Parameters
 
@@ -36,7 +36,10 @@ None.
 |-----------|-----------------------------------------------------------------|------------------|
 | `result`  | result code: 1 = success, 2 = too many results, -2 = no results | integer          |
 | `epidata` | list of results                                                 | array of objects |
-| ...       | ...                                                             | ...              | <!-- TODO -->
+| `epidata[].fluview` | Metadata for [FluView](fluview.md)                                  | array of objects |
+| `epidata[].twitter` | Metadata for [Twitter](twitter.md)                                  | array of objects |
+| `epidata[].wiki`    | Metadata for [Wikipedia](wiki.md)                                   | array of objects |
+| `epidata[].delphi`  | Metadata for [Delphi Forecasts](delphi.md)                          | array of objects |
 | `message` | `success` or error message                                      | string           |
 
 # Example URLs

docs/api/README.md

@@ -75,19 +75,12 @@ The base URL is: <https://api.delphi.cmu.edu/epidata/>
 
 ## Specifying Epiweeks, Dates, and Lists
 
-Epiweeks use the U.S. definition. That is, the first epiweek each year is the
-week, starting on a Sunday, containing January 4. See
-[this page](https://www.cmmcp.org/mosquito-surveillance-data/pages/epi-week-calendars-2008-2020)
-for more information.
-
 Formatting for epiweeks is YYYYWW and for dates is YYYYMMDD.
 
-`list` parameters consist of a comma-separated list of individual values or, for numeric parameters, a hyphenated range of values. Examples include:
- - `param=201530` *(A single epiweek)*
- - `param=201401,201501,201601` *(Several epiweeks)*
- - `param=200501-200552` *(A range of epiweeks)*
- - `param=201440,201501-201510` *(Several epiweeks, including a range)*
- - `param=20070101-20071231` *(A range of dates)*
+See [Date Formats](date_formats.html) for full details on specifying epiweeks, dates, lists, and ranges.
+
+`list` parameters consist of a comma-separated list of individual values or, for numeric parameters, a hyphenated range of values.
+
 
 ## Universal Parameters
 
@@ -111,8 +104,8 @@ The parameters available for each source are documented in each linked source-sp
 
 | Endpoint | Name | Description | Restricted? |
 | --- | --- | --- | --- |
-| [`cdc`](cdc.md) | CDC Page Hits | ... <!-- TODO --> | yes |
-| [`delphi`](delphi.md) | Delphi's Forecast | ... <!-- TODO --> | no |
+| [`cdc`](cdc.md) | CDC Page Hits | CDC total and by topic webpage visits. | yes |
+| [`delphi`](delphi.md) | Delphi's Forecast | Delphi's ILINet outpatient doctor visits forecasts. | no |
 | [`ecdc_ili`](ecdc_ili.md) | ECDC ILI | ECDC ILI data from the ECDC website. | no |
 | [`flusurv`](flusurv.md) | FluSurv | FluSurv-NET data (flu hospitaliation rates) from CDC. | no |
 | [`fluview`](fluview.md) | FluView | Influenza-like illness (ILI) from U.S. Outpatient Influenza-like Illness Surveillance Network (ILINet). | no |
@@ -125,25 +118,25 @@ The parameters available for each source are documented in each linked source-sp
 | [`nidss_flu`](nidss_flu.md) | NIDSS Flu | Outpatient ILI from Taiwan's National Infectious Disease Statistics System (NIDSS). | no |
 | [`nowcast`](nowcast.md) | ILI Nearby | A nowcast of U.S. national, regional, and state-level (weighted) percent ILI, available seven days (regionally) or five days (state-level) before the first ILINet report for the corresponding week. | no |
 | [`quidel`](quidel.md) | Quidel | Data provided by Quidel Corp., which contains flu lab test results. | yes |
-| [`sensors`](sensors.md) | Delphi's Digital Surveillance Sensors | Digital surveillance signals for influenza. | no |
+| [`sensors`](sensors.html) | Delphi's Digital Surveillance Sensors | Influenza and dengue digital surveillance sensors. | partially |
 | [`twitter`](twitter.md) | Twitter Stream | Estimate of influenza activity based on analysis of language used in tweets from [HealthTweets](http://HealthTweets.org/). | yes |
 | [`wiki`](wiki.md) | Wikipedia Access Logs | Number of page visits for selected English, Influenza-related wikipedia articles. | no |
 
 ### Dengue Data
 
 | Endpoint | Name | Description | Restricted? |
 | --- | --- | --- | --- |
-| [`dengue_nowcast`](dengue_nowcast.md) | Delphi's Dengue Nowcast | Nowcast of dengue in Puerto Rico and other regions. |... <!-- TODO --> |
-| [`dengue_sensors`](dengue_sensors.md) | Delphi's Dengue Digital Surveillance Sensors | Digital surveillance signals for dengue. | ... <!-- TODO --> |
-| [`nidss_dengue`](nidss_dengue.md) | NIDSS Dengue | Counts of confirmed dengue cases from Taiwan's NIDSS. | no |
-| [`paho_dengue`](paho_dengue.md) | PAHO Dengue | Dengue cases reported by PAHO. | ... <!-- TODO --> |
+| [`dengue_nowcast`](dengue_nowcast.md) | Delphi's Dengue Nowcast | Delphi's PAHO dengue nowcasts (North and South America). | no |
+| [`dengue_sensors`](dengue_sensors.md) | Delphi's Dengue Digital Surveillance Sensors | PAHO dengue digital surveillance sensors (North and South America). | yes |
+| [`nidss_dengue`](nidss_dengue.md) | NIDSS Dengue | NIDSS dengue cases (Taiwan). | no |
+| [`paho_dengue`](paho_dengue.md) | PAHO Dengue | PAHO dengue data (North and South America). | no |
 
 ### Norovirus Data
 
 | Endpoint | Name | Description | Restricted? |
 | --- | --- | --- | --- |
-| [`meta_norostat`](meta_norostat.md) | NoroSTAT Metadata | Metadata for NoroSTAT data. | ... <!-- TODO --> |
-| [`norostat`](norostat.md) | NoroSTAT | Suspected and confirmed norovirus outbreaks reported by state health departments to the CDC. | ... <!-- TODO --> |
+| [`meta_norostat`](meta_norostat.md) | NoroSTAT Metadata | Metadata for the NoroSTAT endpoint. | yes |
+| [`norostat`](norostat.md) | NoroSTAT | CDC NoroSTAT norovirus outbreaks. | yes |
 
 ### Deprecated
 * `ilinet` - replaced by [`fluview`](fluview.md)

docs/api/cdc.md

@@ -13,10 +13,10 @@ nav_order: 2
 | :--- | :--- |
 | **Source Name** | `cdc` |
 | **Data Source** | CDC influenza surveillance data |
-| **Geographic Coverage** | National, HHS regions, Census divisions, and US states (see [Geographic Codes](geographic_codes.html#us-regions-and-states)) |
-| **Temporal Resolution** | Weekly (Epiweek) |
-| **Update Frequency** | Inactive - No longer updated since 2020w03 (2020-01-12) |
-| **Earliest Date** | 2013w02 (2013-01-06) |
+| **Geographic Levels** | National, HHS regions, Census divisions, and US states (see [Geographic Codes](geographic_codes.html#us-regions-and-states)) |
+| **Temporal Granularity** | Weekly (Epiweek) |
+| **Reporting Cadence** | Inactive - No longer updated since 2020w03 (2020-01-12) |
+| **Temporal Scope Start** | 2013w02 (2013-01-06) |
 
 <!-- | **License** | Permission by CDC flu division | -->
 
@@ -41,7 +41,6 @@ General topics not specific to any particular endpoint are discussed in the
 
 The base URL is: <https://api.delphi.cmu.edu/epidata/cdc/>
 
-See [this documentation](README.md) for details on specifying epiweeks, dates, and lists.
 
 ## Parameters
 
@@ -50,7 +49,7 @@ See [this documentation](README.md) for details on specifying epiweeks, dates, a
 | Parameter | Description | Type |
 | --- | --- | --- |
 | `auth` | password | string |
-| `epiweeks` | epiweeks | `list` of epiweeks |
+| `epiweeks` | epiweeks (see [Date Formats](date_formats.html)) | `list` of epiweeks |
 | `locations` | locations | `list` of location codes: `nat` (national), HHS regions (`hhs1`-`hhs10`), Census divisions (`cen1`-`cen9`), or state codes (see [Geographic Codes](geographic_codes.html#us-regions-and-states)) |
 
 ## Response

docs/api/covid_hosp.md

@@ -13,10 +13,10 @@ nav_order: 2
 | :--- | :--- |
 | **Source Name** | `covid_hosp_state_timeseries` |
 | **Data Source** | [US Department of Health & Human Services](https://healthdata.gov/Hospital/COVID-19-Reported-Patient-Impact-and-Hospital-Capa/g62h-syeh) |
-| **Geographic Coverage** | US States plus DC, PR, and VI (see [Geographic Codes](geographic_codes.html#us-states-and-territories)) |
-| **Temporal Resolution** | Daily |
-| **Update Frequency** | Inactive - No longer updated since 2024-04-27 |
-| **Earliest Date** | 2020-01-01 |
+| **Geographic Levels** | US States plus DC, PR, and VI (see [Geographic Codes](geographic_codes.html#us-states-and-territories)) |
+| **Temporal Granularity** | Daily |
+| **Reporting Cadence** | Inactive - No longer updated since 2024-04-27 |
+| **Temporal Scope Start** | 2020-01-01 |
 | **License** | [Public Domain US Government](https://www.usa.gov/government-works) |
 
 ## Overview
@@ -55,7 +55,6 @@ General topics not specific to any particular data source are discussed in the
 
 The base URL is: <https://api.delphi.cmu.edu/epidata/covid_hosp_state_timeseries/>
 
-See [this documentation](README.md) for details on specifying locations and dates.
 
 ## Parameters
 
@@ -64,13 +63,13 @@ See [this documentation](README.md) for details on specifying locations and date
 | Parameter | Description                    | Type                           |
 |-----------|--------------------------------|--------------------------------|
 | `states`  | two-letter state abbreviations (see [Geographic Codes](geographic_codes.html#us-states-and-territories)) | `list` of states               |
-| `dates`   | dates                          | `list` of dates or date ranges |
+| `dates`   | dates (see [Date Formats](date_formats.md)) | `list` of dates or date ranges |
 
 ### Optional
 
 | Parameter | Description | Type                                   |
 |-----------|-------------|----------------------------------------|
-| `issues`  | issues      | `list` of "issue" dates or date ranges |
+| `issues`  | issues (see [Date Formats](date_formats.md))      | `list` of "issue" dates or date ranges |
 
 If `issues` is not specified, then the most recent issue is used by default.
 

docs/api/covid_hosp_facility.md

@@ -13,10 +13,10 @@ nav_order: 2
 | :--- | :--- |
 | **Source Name** | `covid_hosp_facility` |
 | **Data Source** | [US Department of Health & Human Services](https://healthdata.gov/Hospital/COVID-19-Reported-Patient-Impact-and-Hospital-Capa/anag-cw7u) |
-| **Geographic Coverage** | Healthcare facility |
-| **Temporal Resolution** | Weekly (Friday -- Thursday) |
-| **Update Frequency** | Inactive - No longer updated since 2024w08 |
-| **Earliest Date** | 2020-07-31 |
+| **Geographic Levels** | Healthcare facility |
+| **Temporal Granularity** | Weekly (Friday -- Thursday) |
+| **Reporting Cadence** | Inactive - No longer updated since 2024w08 |
+| **Temporal Scope Start** | 2020-07-31 |
 | **License** | [Public Domain US Government](https://www.usa.gov/government-works) |
 
 ## Overview

docs/api/covid_hosp_facility_lookup.md

@@ -13,12 +13,12 @@ nav_order: 2
 | :--- | :--- |
 | **Source Name** | `covid_hosp_facility_lookup` |
 | **Data Source** | [US Department of Health & Human Services](https://healthdata.gov/Hospital/COVID-19-Reported-Patient-Impact-and-Hospital-Capa/anag-cw7u) |
-| **Geographic Coverage** | Healthcare facility ([state](geographic_codes.html#us-states-and-territories), ccn city, zip, fips) |
-| **Update Frequency** | Inactive - No longer updated since 2024w08 |
+| **Geographic Levels** | Healthcare facility ([state](geographic_codes.html#us-states-and-territories), ccn city, zip, fips) |
+| **Reporting Cadence** | Inactive - No longer updated since 2024w08 |
 | **License** | [Public Domain US Government](https://www.usa.gov/government-works) |
 
-<!-- | **Earliest Date** | N/A |
-| **Temporal Resolution** | N/A -->
+<!-- | **Temporal Scope Start** | N/A |
+| **Temporal Granularity** | N/A -->
 
 ## Overview
 {: .no_toc}

docs/api/covidcast_meta.md

@@ -16,7 +16,6 @@ geographic levels at which they are reported.
 
 The base URL is: <https://api.delphi.cmu.edu/epidata/covidcast_meta/>
 
-See [this documentation](README.md) for details on specifying epiweeks, dates, and lists.
 
 ### Parameters
 

docs/api/covidcast_times.md

@@ -39,7 +39,7 @@ The available time types include:
 * `week`: A weekly observation, recording events over 7 days. The `time_value`
   and `issue` are reported with a year and a week number ranging from 1 to 53,
   in `YYYYWW` format. These weeks are [MMWR
-  weeks](https://wwwn.cdc.gov/nndss/document/MMWR_Week_overview.pdf) as defined
+  weeks](https://ndc.services.cdc.gov/wp-content/uploads/MMWR_week_overview.pdf) as defined
   by the National Notifiable Diseases Surveillance System, also known as
   "epiweeks". (The [API clients](covidcast_clients.md) convert these into date
   objects representing the first day of the MMWR week, and for those not using

docs/api/date_formats.md

@@ -0,0 +1,53 @@
+---
+title: Date Formats
+parent: Other Endpoints (COVID-19 and Other Diseases)
+nav_order: 101
+---
+
+# Date Formats
+{: .no_toc}
+
+This page documents the valid date and time formats accepted by various API endpoints.
+
+## Table of contents
+{: .no_toc .text-delta}
+
+1. TOC
+{:toc}
+
+## Epiweeks
+
+Epiweeks (Epidemiological Weeks) use the [U.S. CDC definition](https://ndc.services.cdc.gov/wp-content/uploads/MMWR_week_overview.pdf). That is, the first epiweek each year is the week, starting on a Sunday, containing January 4.
+
+**Format:** `YYYYWW`
+*   `YYYY`: Four-digit year
+*   `WW`: Two-digit week (01-53)
+
+Example: `201501` represents the first epiweek of 2015.
+
+See [this page](https://www.cmmcp.org/mosquito-surveillance-data/pages/epi-week-calendars-2008-2020) for more information and calendars.
+
+## Dates
+
+Dates generally follow the ISO 8601 basic format, but without hyphens.
+
+**Format:** `YYYYMMDD`
+*   `YYYY`: Four-digit year
+*   `MM`: Two-digit month (01-12)
+*   `DD`: Two-digit day (01-31)
+
+Example: `20150201` represents February 1st, 2015.
+
+## Specifying Lists and Ranges
+
+Many API parameters accept lists of values or ranges.
+
+`list` parameters consist of a comma-separated list of individual values or, for numeric parameters (like epiweeks or dates), a hyphenated range of values.
+
+**Examples:**
+
+*   **Single Value:** `param=201530`
+*   **List of Values:** `param=201401,201501,201601`
+*   **Range:** `param=200501-200552`
+*   **Mixed List and Range:** `param=201440,201501-201510`
+*   **Date Range:** `param=20070101-20071231`

docs/api/delphi.md

@@ -13,10 +13,10 @@ nav_order: 2
 | :--- | :--- |
 | **Source Name** | `delphi` |
 | **Data Source** | [Delphi](https://delphi.cmu.edu/) |
-| **Temporal Resolution** | Weekly (Epiweek) |
-| **Systems available** | `af`, `eb`, `ec`, `sp`, `st` |
-| **Update Frequency** | Inactive - No longer updated since 2020w19 |
-| **Earliest Date** | 2014w41 |
+| **Temporal Granularity** | Weekly (Epiweek) |
+| **Systems available** | `af`, `eb`, `ec`, `sp`, `st` (see [details below](#forecasting-systems)) |
+| **Reporting Cadence** | Inactive - No longer updated since 2020w19 |
+| **Temporal Scope Start** | Varies by system (earliest 2014w41) |
 | **License** | [CC BY](https://creativecommons.org/licenses/by/4.0/) |
 
 ## Overview
@@ -29,6 +29,19 @@ General topics not specific to any particular endpoint are discussed in the
 [contributing](README.md#contributing), [citing](README.md#citing), and
 [data licensing](README.md#data-licensing).
 
+### Forecasting Systems
+
+The following systems are available, representing different forecasting models for ILINet % weighted ILI:
+
+| Code | Name | 
+| :--- | :--- | 
+| `af` | [Archefilter](http://reports-archive.adm.cs.cmu.edu/anon/cbd/CMU-CB-16-101.pdf#Appendix.1.B) | 
+| `eb` | [Empirical Bayes](https://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1004382) | 
+| `ec` | [Epicast](https://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1005248) | 
+| `sp` | [Pinned Spline](http://reports-archive.adm.cs.cmu.edu/anon/cbd/CMU-CB-16-101.pdf#Appendix.1.A) | 
+| `st` | [Delphi-Stat](https://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1006134) 
+
+
 ## Table of contents
 {: .no_toc .text-delta}
 
@@ -39,7 +52,6 @@ General topics not specific to any particular endpoint are discussed in the
 
 The base URL is: <https://api.delphi.cmu.edu/epidata/delphi/>
 
-See [this documentation](README.md) for details on specifying epiweeks, dates, and lists.
 
 ## Parameters
 
@@ -48,7 +60,7 @@ See [this documentation](README.md) for details on specifying epiweeks, dates, a
 | Parameter | Description | Type                                 |
 |-----------|-------------|--------------------------------------|
 | `system`  | system      | system name (`af`, `eb`, `ec`, `sp`, `st`) |
-| `epiweek` | epiweek     | epiweek when forecast was made       |
+| `epiweek` | epiweek (see [Date Formats](date_formats.html))     | epiweek when forecast was made       |
 
 ## Response