Contributor onboarding guidance has been refreshed
The Zambia Energy Data Platform has updated its contributor onboarding guidance to make dataset preparation more predictable for publishing teams.
The goal is straightforward: reduce avoidable review cycles and help contributors submit better-prepared datasets the first time.
ImportantThis article is written as a rich
.mdexample. It uses standard markdown and GFM features only, without JSX, so the site can validate both authoring paths.
What was improved
The refreshed guidance now places more emphasis on:
- minimum metadata requirements
- naming conventions for resources
- clear ownership and contact details
- explanation of approval-based access where relevant
Before and after
| Area | Previous experience | Updated experience |
|---|---|---|
| Submission checklist | Spread across several notes | Consolidated into one short checklist |
| Metadata expectations | Often implied | Explicit and front-loaded |
| File naming guidance | Inconsistent | Standard examples included |
| Access requirements | Easy to miss | Called out early in the workflow |
Publication checklist
- add a clear dataset title
- provide a concise public-facing description
- identify owner and maintainer contacts
- define update frequency when known
- complete final editorial review for all new submissions
Contributor workflow
- Prepare the dataset package and identify the responsible owner.
- Confirm that the title, summary, and contact details are publication-ready.
- Review whether access should remain public or approval-based.
- Submit the package for editorial and technical validation.
Example naming pattern
zedp_generation_capacity_2026_q1.csv
zedp_distribution_outages_2026_03.xlsx
zedp_solar_installations_province_summary.geojson
Editorial note
Better onboarding does not just help contributors. It also improves the experience for end users, because datasets become easier to understand, compare, and reuse once titles, descriptions, and update labels follow a shared pattern.
Clear submission guidance is one of the fastest ways to improve public trust in a growing data platform.
Follow-up actions
- publish a short contributor FAQ for recurring submission mistakes
- add more examples for tabular, geospatial, and document-based resources
- connect future training sessions to the same contributor checklist
Teams preparing datasets for upcoming publication cycles are encouraged to use the refreshed guidance as the default starting point.