developer.overheid.nl

Ontwikkelaarsportaal van de Nederlandse overheid

Ga naar hoofdinhoud

Hoe draag ik een gastblog aan?

Wil jij je stem laten horen via onze blog? Omdat wij het belang zien van een breedgedragen discussie helpen we jou hier graag bij.

Markdown

  • Een bijdrage aan onze blog dien je in alle gevallen aan te dragen als Markdown bestand.
  • Een markdown bestand heeft de .md bestandsextensie.
  • De filename van jouw blog ziet er bijvoorbeeld zo uit: mijn-blog-over-grafana.md.

Voorbeeld

Voorbeeld van correct geformatteerde blogpost in markdown
---
authors: [martin-van-der-plas]
tags: [data-bij-de-bron, fds, api, oauth, digid, pkio, eherkenning, eidas, oidc, saml]
---
# Titel

Dit is de intro met een hele pakkende tekst om op "Lees meer te klikken".

<!-- truncate -->

## Kop 2

En hier gaat het verhaal weer verder.

### Kop 2.1

Lorem ipsum.

Er zijn verschillende manieren om een gastblog aan te dragen:

- Stuur ons een e-mail

Stuur een e-mail naar developer.overheid@geonovum.nl met het markdown-bestand van jouw blogpost.

- Maak een Gist en dien een issue in

Je kunt een artikel schrijven in Markdown en deze als een Gist opslaan. Zorg ervoor dat je de Gist openbaar maakt en de link naar de Gist deelt in een issue.

- Maak een Pull Request

Ook is het mogelijk om een blogpost aan te bieden door middel van een pull request. Let er wel op dat je de blogpost in de draft map zet:

/blog/draft/example.md

Als je nog geen lid bent van onze repository, maak dan eerst een fork. Deze fork kun je vervolgens aanbieden als pull request bij ons.