Opmerkingen over Verdieping Uitwisselprotocollen

[adgerrits]

Algemeen: heel goed dat deze pagina er is!
Opmerkingen n.a.v. de tekst op https://minbzk.github.io/gdi-gegevensuitwisseling/content/elements/id-1d2d4327d948422eadfcd5208208ec3a.html

1. "In onderstaande paragrafen vergelijken we de verschillende basisvormen en benoemen we de belangrijkste uitwisselprotocollen" Wat wordt bedoeld met 'uitwisselprotocollen' (aanbevolen standaarden?) Ik zou ipv 'uitiwsselprotocollen' ide term 'Gegevensuitwissel-vormen' gebruiken.
2. "Service-oriëntatie" => de beschrijving omvat eigenlijk RPC; dat zou ik duidelijker beschrijven zodat je bijv. ook de gRPC-standaard een plek kunt geven.
3. "Tegenwoordig is er toenemende aandacht voor integratie op basis van API’s, dat je kunt zien als onderdeel van het paradigma resource-oriëntatie." API's staan los van resource-orientatie en zijn er al zo lang als er software wordt gemaakt.
4. "Daarnaast krijgt de GraphQL standaard veel aandacht" => "daarnaast zijn er API's die de GraphQL standaard voor queries gebruiken.
5. " of er is sprake van zogenaamde event streams, een opslag van de opgetreden events" => weglaten die zin want schept alleen maar verwarring; ook bij event streams pubsub toepasbaar + er zijn ook andere patronen
6. "Gegevensoriëntatie" => Zou ik "Gegevensobjectorientatie" noemen; essentie is dat je objecten met attributen uitwisselt
7. "Berichtoriëntatie" => "zijn de precieze aanleiding en de verwerking ervan zijn daarbij minder belangrijk" => (?) weg. + "veelal zijn dat periodieke batchprocessen" (?) weg + "(vaak grote) berichten" (?) (vaak grote) weg.
8. "Weboriëntatie" => is dit niet resource-orientatie? Onze vriend Roy Fielding had het over dit soort via het web vindbare resources toen hij REST bedacht.
9. Afbeelding: altijd goed zo'n afbeelding. Maar: waarom onderscheid tussen raadpleging en mutaties (zie ook Digikoppeling ervaringen daarmee)? + Portaal: 'eenvoudige raadpleging = resource-orientatie' is m.i. onjuist. Eenvoudig betekent dat je een gerichte kunt stellen en een op maat gemaakt antwoord krijgt. Daarvoor is resource-georienteerd niet geschikt.
10. Digikoppeling: tekst bij bullet 3 en 4 is omgedraaid.
11. Digikoppeling: "Dat is bijvoorbeeld relevant als zich tussen aanbieder en afnemer een niet vertrouwde intermediair bevindt." => of je moet goede afspraken maken met de intermediair (zo heeft de IBeveiligigingsdienst me geleerd).
12. Digikoppeling: "Partijen kunnen kiezen welk interactiepatroon nodig is voor gegevensuitwisseling." => zin weghalen. "interactiepatroon" is wat anders en maakt het hier nodeloos verwarrend.
13. Doorontwikkeling: "de FSC-standaard ... waardevol zijn bij het gebruik van API’s" => HTTP API's
14. Doorontwikkeling: "GraphQL is bijvoorbeeld een logisch protocol om te gebruiken als er sprake is van complexe bevragingen" => is bijvoorbeeld een mogelijk beter bruikbaar protocol
15. Doorontwikkeling: "Mogelijk kan de huidige koppelvlakstandaard REST API generieker worden opgezet om een aantal van dit soort protocollen ook te ondersteunen." = Zin weglaten. Lijkt me niet verstandig dus zou ik het hier niet zo vrijblijvend opperen.