Commit Graph

7 Commits

Author SHA1 Message Date
Elie Habib
611eb6a6fb docs: add Data Sources attribution table to README (#2349)
* docs: add Data Sources attribution table to README

* docs: link README data sources table to full catalog, clarify 30+ sources

* docs: replace data sources table with single link to catalog (no duplication)

* docs: add Provider Credits section to data-sources catalog with linked attributions
2026-03-27 11:42:17 +04:00
Elie Habib
e5db9a0700 docs: update Mintlify docs for recent features (#1693)
- finance-data.mdx: Add US Treasury customs revenue to Trade Policy
  section (Revenue tab, free API, FYTD comparison, desktop support)
- features.mdx: Expand CMD+K section from 5 categories to full 55
  panel coverage with organized subcategories
- data-sources.mdx: Update advisory section for gold standard
  migration (Railway seed, 265-entry country map, relay proxy)
- architecture.mdx: Add 12 missing seed scripts to Railway pipeline
  table (forecasts, conflict-intel, economy, supply-chain-trade,
  security-advisories, usni-fleet, gdelt-intel, research, etc.)
- changelog.mdx + CHANGELOG.md: Add unreleased entries for customs
  revenue, advisory migration, CMD+K coverage, R2 traces, and 6 fixes
2026-03-16 00:16:09 +04:00
Elie Habib
09a582e089 fix(docs): correct numerical inaccuracies, add missing features and variants (#1472)
* fix(docs): correct variant count from 4 to 5

Updated overview.mdx and architecture.mdx to reflect all 5 platform
variants (World Monitor, Tech Monitor, Happy Monitor, Finance Monitor,
Commodity Monitor). Previously only 2 were listed in the table and
the text said "four".

* fix(docs): correct all numerical inaccuracies across documentation

Updated counts verified against actual codebase:
- AI datacenters: 111 → 313
- Undersea cables: 55 → 86
- Map layers: 45 → 49
- News sources: 80+ → 344
- Service domains: 22 → 24
- CII countries: 20 → 24
- Military bases: 210/220+ → 226
- Strategic ports: 61/83 → 62
- Airports: 30/107 → 111
- Chokepoints: 6/8 → 9
- Signal entities: 100+/600+ → 66
- Variant count: four → five (added Commodity Monitor)

* docs(overview): add Happy, Finance, and Commodity Monitor sections

Added detailed documentation sections for the three previously
undocumented platform variants, including layers, panels, and
news categories for each.

* docs(features): document 13 previously undocumented features

Added: trade routes, FIRMS fire detection, webcam surveillance,
country brief, aviation intelligence panel, climate anomalies,
displacement tracking, Gulf economies, WTO trade policy, central
banks & BIS, market watchlist, NOTAM closure detection, and
offline ML capabilities.

* docs: standardize terminology, add cross-references, fix stale refs

Phase 4: Renamed "News Importance Scoring" to "Headline Scoring",
"Signal Correlation" to "Cross-Stream Correlation". Added cross-refs
between CII/convergence, CORS/API-key, maritime/finance chokepoints.
Deduplicated Population Exposure content. Clarified hotspot vs focal
point distinction.

Phase 5: Rewrote daily_stock_analysis as historical context. Added
legacy note for api/*.js files. Added OREF 24h rolling history boost
and GPS jamming classification thresholds to algorithms.mdx. Fixed
orbital-surveillance tier table contradictions.

Phase 6: Fixed orphaned markdown separator in orbital-surveillance.

* fix(docs): catch remaining stale numbers in secondary doc files

Fixed stale counts in data-sources.mdx, strategic-risk.mdx,
documentation.mdx, ai-intelligence.mdx, PRESS_KIT.md, and
roadmap-pro.md that were missed in the initial pass.

* fix(docs): address review findings from fresh-eyes pass

- desktop-app.mdx: "four variants" → "five", "22 services" → "24"
- infrastructure-cascade.mdx: chokepoints 8 → 9, node total 279 → 350
- data-sources.mdx: chokepoints 8 → 9
- overview.mdx: remove duplicated intro sentence
- getting-started.mdx: fix stale file tree comments (AI clusters, airports, entities)
2026-03-12 07:48:47 +04:00
Elie Habib
1f38dea225 docs: restructure documentation into focused, navigable pages (#1465)
* docs: restructure documentation into focused, navigable pages (#docs-reorg)

Break the 4096-line documentation.mdx monolith into 13 focused pages
organized by feature area. Reorganize Mintlify navigation from 5 generic
groups into 7 feature-based groups. Move Orbital Surveillance from
Infrastructure to Map Layers where it belongs.

- Extract: signal-intelligence, features, overview, hotspots, CII,
  geographic-convergence, strategic-risk, infrastructure-cascade,
  military-tracking, maritime-intelligence, natural-disasters,
  contributing, getting-started
- Append to: architecture.mdx (9 sections), ai-intelligence.mdx (3 sections)
- Fix legacy .md links in map-engine.mdx, maps-and-geocoding.mdx
- Slim documentation.mdx to an 80-line index/hub page
- Eliminate duplicate content that caused repeated headings

* fix(docs): remove duplicate H1 headings from all Mintlify pages

Mintlify auto-renders the frontmatter `title` as an H1, so having
`# Title` in the body creates a doubled heading on every page.
Remove the redundant H1 (and repeated description lines) from all
31 .mdx files.
2026-03-12 06:44:35 +04:00
Elie Habib
8766b45a57 fix(docs): comprehensive MDX angle bracket escaping (#1453)
* fix(docs): comprehensive MDX angle bracket escaping

Escape all bare < patterns that MDX interprets as JSX across
documentation.mdx, algorithms.mdx, ai-intelligence.mdx,
data-sources.mdx, finance-data.mdx, relay-parameters.mdx,
and maps-and-geocoding.mdx.

* feat(lint): add MDX bare angle bracket lint to pre-push

Adds tests/mdx-lint.test.mjs that scans all docs/*.mdx files for
bare <digit and <hyphen patterns outside code fences. These break
Mintlify's MDX parser. Wired into .husky/pre-push so issues are
caught before reaching Mintlify.
2026-03-12 00:45:52 +04:00
Elie Habib
60fa0c5907 fix(docs): escape angle brackets for MDX compatibility (#1452)
MDX interprets bare <digit patterns as JSX tags. Escape with &lt;
in architecture.mdx, data-sources.mdx, and documentation.mdx.
2026-03-12 00:38:09 +04:00
Elie Habib
caa3e9f82f fix(docs): rename doc files to lowercase for Mintlify (#1451)
* fix(docs): rename doc files to lowercase kebab-case for Mintlify

Mintlify serves pages at lowercase URLs. Uppercase filenames caused
404s on the Documentation tab. Renames all 18 doc files, updates
docs.json references, and fixes internal cross-links.

* fix(docs): rename .md to .mdx for Mintlify compatibility

Mintlify expects .mdx files. Plain .md files were not being found,
causing 404s on all documentation pages.

* feat(docs): add navbar links and footer with site variants

- Navbar: Live App, Tech, Finance, Blog links + GitHub CTA
- Footer: World Monitor variants + Resources columns
- Logo links back to worldmonitor.app
2026-03-12 00:30:15 +04:00