Commit Graph

9 Commits

Author SHA1 Message Date
Elie Habib
e23f1cf85b docs: add dedicated license page with anti-rebranding and enforcement sections (#1490)
Extract license content from contributing.mdx into its own first-class
docs/license.mdx page. Add prominent warnings about rebranding/renaming
being prohibited without a commercial license, an enforcement section,
and expanded commercial use restrictions.

Update README.md license section to reflect the dual-license model
(AGPL-3.0 for non-commercial, commercial license required for business
use). Previously it incorrectly stated commercial use was allowed under
AGPL alone.

Update cross-references in documentation.mdx and getting-started.mdx to
point to the new /license page.
2026-03-12 14:43:28 +04:00
Elie Habib
d1acabf41d docs: replace redundant TOC landing page with proper introduction (#1478)
The documentation.mdx page was just a table of contents duplicating the
sidebar navigation, with irrelevant variant demo links at the top. Replace
with a concise introduction that explains what World Monitor is, what
users can do with it, quick navigation links, and the license summary.
2026-03-12 11:33:42 +04:00
Elie Habib
ddda3e58a1 docs: fix license from MIT to AGPL-3.0 and add license guide (#1476)
getting-started.mdx incorrectly stated "MIT" as the license.
The actual license is AGPL-3.0-only (per LICENSE file and package.json).

Adds a comprehensive license section to contributing.mdx explaining:
- What AGPL-3.0 means in plain language
- Rights and obligations table
- Common scenarios (self-hosting, public deployment, API usage, PRs)
- Why AGPL was chosen for this project
2026-03-12 08:15:08 +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
2a7d7fc3fe fix: standardize brand name to "World Monitor" with space (#1463)
Replace "WorldMonitor" with "World Monitor" in all user-facing display
text across blog posts, docs, layouts, structured data, footer, offline
page, and X-Title headers. Technical identifiers (User-Agent strings,
X-WorldMonitor-Key headers, @WorldMonitorApp handle, function names)
are preserved unchanged. Also adds anchors color to Mintlify docs config
to fix blue link color in dark mode.
2026-03-12 01:28:16 +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