Skip to content

docs: split maps.md into per-section source files and refresh content [PR8] [DHIS2-18242]#3652

Merged
BRaimbault merged 10 commits into
feat/DHIS2-18242from
feat/DHIS2-18242-PR8
Jun 2, 2026
Merged

docs: split maps.md into per-section source files and refresh content [PR8] [DHIS2-18242]#3652
BRaimbault merged 10 commits into
feat/DHIS2-18242from
feat/DHIS2-18242-PR8

Conversation

@BRaimbault
Copy link
Copy Markdown
Collaborator

@BRaimbault BRaimbault commented May 18, 2026

Summary

The monolithic docs/maps.md file (~1900 lines) has been split into numbered source files under docs/src/, making individual sections easier to find, edit, and review. A build script reassembles them into the single output file that DHIS2 documentation tooling consumes.

  • Split docs/maps.md into 20 numbered source files under docs/src/ (one per section, e.g. 04-thematic-layer.md, 09-earth-engine-layer.md)
  • Added scripts/build-docs.js to concatenate source files back into docs/maps.md (with image path rewriting)
  • Added docs:build and docs:format npm scripts (yarn docs:build formats sources then regenerates the output file)
  • Updated .prettierignore to allow formatting of docs/src/*.md while ignoring the generated docs/maps.md and docs/resources/
  • Refreshed all layer dialog screenshots to reflect the current UI
  • Reviewed and improved prose across all documentation sections

Notes

docs/maps.md is now a generated file - edits should be made to the source files in docs/src/ and the output rebuilt with yarn docs:build.

@BRaimbault BRaimbault requested a review from karolinelien May 18, 2026 12:46
@dhis2-bot
Copy link
Copy Markdown
Contributor

dhis2-bot commented May 18, 2026

🚀 Deployed on https://pr-3652.maps.netlify.dhis2.org

@dhis2-bot dhis2-bot temporarily deployed to netlify May 18, 2026 12:46 Inactive
@dhis2-bot dhis2-bot temporarily deployed to netlify May 19, 2026 08:19 Inactive
@dhis2-bot dhis2-bot temporarily deployed to netlify May 19, 2026 10:47 Inactive
@BRaimbault BRaimbault changed the title docs: split maps.md into per-section source files and refresh content docs: split maps.md into per-section source files and refresh content [PR8] May 19, 2026
@BRaimbault BRaimbault marked this pull request as ready for review May 19, 2026 10:49
Copy link
Copy Markdown
Collaborator Author

@BRaimbault BRaimbault left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ready for review

@dhis2-bot dhis2-bot temporarily deployed to netlify May 19, 2026 10:50 Inactive
@dhis2-bot dhis2-bot temporarily deployed to netlify May 19, 2026 13:18 Inactive
@dhis2-bot dhis2-bot temporarily deployed to netlify May 20, 2026 10:52 Inactive
@BRaimbault BRaimbault changed the title docs: split maps.md into per-section source files and refresh content [PR8] docs: split maps.md into per-section source files and refresh content [PR8] [DHIS2-18242] May 30, 2026
Copy link
Copy Markdown
Collaborator

@karolinelien karolinelien left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great job, I added some comments!

Comment thread docs/src/05-event-layer.md Outdated
Comment thread docs/src/05-event-layer.md Outdated
Comment thread docs/src/05-event-layer.md Outdated
Comment thread docs/src/01-about.md Outdated
Comment thread docs/src/04-thematic-layer.md Outdated
Comment thread docs/src/05-event-layer.md Outdated
Comment thread docs/src/06-tracked-entity-layer.md Outdated
@dhis2-bot dhis2-bot temporarily deployed to netlify June 2, 2026 09:07 Inactive
@dhis2-bot dhis2-bot temporarily deployed to netlify June 2, 2026 12:03 Inactive
@BRaimbault BRaimbault force-pushed the feat/DHIS2-18242-PR8 branch from b623a23 to 9945514 Compare June 2, 2026 13:59
@dhis2-bot dhis2-bot temporarily deployed to netlify June 2, 2026 14:01 Inactive
Base automatically changed from feat/DHIS2-18242-PR7 to feat/DHIS2-18242 June 2, 2026 14:31
@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented Jun 2, 2026

@dhis2-bot dhis2-bot temporarily deployed to netlify June 2, 2026 14:38 Inactive
@BRaimbault BRaimbault merged commit 9f9286c into feat/DHIS2-18242 Jun 2, 2026
28 checks passed
@BRaimbault BRaimbault deleted the feat/DHIS2-18242-PR8 branch June 2, 2026 14:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants