Skip to content

Latest commit

 

History

History
52 lines (39 loc) · 1.37 KB

Herstructurering.md

File metadata and controls

52 lines (39 loc) · 1.37 KB
Raw

Voorstel voor nieuwe documenten indeling

Door: JvG Versie: 0.1 Datum: 06-11-2019

Deel 1 - API Strategie Algemeen

Doelgroep: Beleidsmakers,Beslissers, enz Dit deel zal geschreven zijn in het Nederlands het bevat de huidige hoofdstukken:

  • Inleiding
  • Communicatie en Beleid
  • Gebruikerswensen
  • verwijzing naar Deel 2a. 2b
  • verwijzing naar Nederlands profiel OAuth
  • Algemene Bijlagen

Deel 2a - API Strategie - Normatief deel

Doelgroep: Developers binnen en buiten de overheid Dit deel zal geschreven zijn in het Engels het bevat de huidige hoofdstukken:

  • Inleiding
  • Designrules exclusief het huidige extenstions document
  • Normatieve bijlagen

Deel 2b - API Strategie - Informatief deel

Doelgroep: Developers binnen en buiten de overheid Dit deel zal geschreven zijn in het Engels het bevat de huidige hoofdstukken:

  • Inleiding
  • Het huidige extenstions document
  • Niet normatieve bijlagen

Herinrichting GitHub repo

alle 3 de documenten krijgen een eigen GitHub repository, dit maakt het ook mogelijk om tzt een document over te dragen aan een andere beheer organisatie zoal ICTU of Logius. Voorstel: Repo: KP-APIs met daarin:

  • API-strategie-algemeen
  • API-strategie-extensies

Repo: API Designrules met daarin:

  • API-designrules (dit is het normatieve deel)

Binnen de repo wordt de standaard Geonovum Respec indeling gebruikt (is iets anders dan de huisstijl!)