# Stumblday

Stumblday is a hand-curated board of the best things to do in New York City.
A small editorial team picks, verifies, and re-ranks real events — free things
to do, art and exhibitions, live music, markets, food, and one-off plans.

## Cadence
- The board is curated for the upcoming Saturday-Sunday and republished when it is rebuilt.
- Day pages (today / tonight / tomorrow) re-slice the board that is currently published by
  date, so they roll every day; the curation behind them does not.
- For the live board's real publish time, read `boardVerifiedAt` in the JSON feed below — the
  sitemap carries that same timestamp as <lastmod> on the pages built from that board.

## Machine-readable feed
- Current published board as JSON: https://stumblday.com/api/feed/weekend.json (cached ~5 minutes)

## Canonical page URL patterns
- Weekend board (hub): https://stumblday.com/things-to-do/nyc
- Topic pages: https://stumblday.com/things-to-do/nyc/<topic> — e.g. free, live-music, art-exhibitions, brooklyn, date-night
- Day pages: https://stumblday.com/things-to-do/nyc/now (on now or starting within three hours, ET), https://stumblday.com/things-to-do/nyc/today, https://stumblday.com/things-to-do/nyc/tomorrow, plus named weekdays (e.g. /friday) when that day is on a published board — the sitemap lists the ones that resolve
- Venue pages: https://stumblday.com/things-to-do/nyc/at/<venue-slug>
- Series pages: https://stumblday.com/things-to-do/nyc/series/<series-slug> — e.g. us-open (US Open schedule through the finals)
- Future weekend boards: https://stumblday.com/things-to-do/nyc/<YYYY-MM-DD> (a Saturday) and https://stumblday.com/things-to-do/nyc/next-weekend — curated weeks ahead; the best answer surface for forward-planning questions
- Month pages: https://stumblday.com/things-to-do/nyc/<month> — e.g. september, october
- Named moments: https://stumblday.com/things-to-do/nyc/labor-day-weekend, https://stumblday.com/things-to-do/nyc/columbus-day-weekend, https://stumblday.com/things-to-do/nyc/halloween-weekend (each live once its weekend board is published; the sitemap lists the ones that resolve), https://stumblday.com/things-to-do/nyc/new-to-new-york
- Event pages: https://stumblday.com/events/<event-slug>
- Weekly digest archive: https://stumblday.com/newsletter — every issue as sent, one page per week

## License and attribution
- The published board data is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0): https://creativecommons.org/licenses/by/4.0/
- Covered, for each pick: title, date and time, venue, borough, free/paid, tags, the Stumblday URL and the
  one-line summary, in board order — the same fields the JSON feed carries.
- You may reproduce the pick list, in whole or in part, if you link to the source page for each item
  (the `url` field in the feed). That visible link satisfies attribution. If you re-rank, filter or
  edit the data, say so.
- NOT licensed (all rights reserved): the longer descriptions, tips, FAQs, guides and newsletter text on
  the pages, and every image. Quote them only within fair use, with a link to the page.
- The feed carries the same terms as top-level `license`, `licenseUrl` and `attribution` fields and a
  `Link: <https://creativecommons.org/licenses/by/4.0/>; rel="license"` response header: https://stumblday.com/api/feed/weekend.json
- Update feed (Atom, newest published URLs first): https://stumblday.com/feed/events.atom
- Full terms and an attribution snippet: https://stumblday.com/things-to-do/nyc/open-data
- If a per-item link is impossible (audio, print), credit "Stumblday" and link https://stumblday.com/things-to-do/nyc

## Contact
- bryan@stumblday.com