Contribute a post

The blog is open to contributions. If you map for this project, run the pipeline somewhere new, or have a critique of a method worth writing down, you can publish it here.

• Preferred: open a pull request against open-energy-transition/earthpv adding your post file (see How to add a post below).
• Or get in touch first: open an issue describing what you want to write, or reach the team through the Community contacts. We are happy to co-author, or to publish a guest post on your behalf.

How to add a post

1. Create docs/blog/posts/YYYY-MM-DD-your-slug.md.

2. Give it front matter with at least a date, plus optional authors and categories:

   ---
   date: 2026-09-01
   authors:
     - earthpv
   categories:
     - Method notes
   ---
   
   # Your post title
   
   One or two sentences of intro that stand alone as the excerpt.
   
   <!-- more -->
   
   The rest of the post.
   

3. If you want a byline of your own, add yourself to docs/blog/.authors.yml and reference that key under authors.

4. Allowed categories are declared in mkdocs.yml (Announcements, Method notes, Field reports, Results, Perspectives) -- add a new one there in the same PR if you need it.
5. Preview locally with pixi run -e docs docs-serve. CI builds the site with mkdocs build --strict, so a bad link or an undeclared category fails the build.