Skip to content

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

Open
BRaimbault wants to merge 7 commits into
feat/DHIS2-18242-PR7from
feat/DHIS2-18242-PR8
Open

docs: split maps.md into per-section source files and refresh content [PR8]#3652
BRaimbault wants to merge 7 commits into
feat/DHIS2-18242-PR7from
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
@sonarqubecloud
Copy link
Copy Markdown

@dhis2-bot dhis2-bot temporarily deployed to netlify May 20, 2026 10:52 Inactive
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.

2 participants