Peter Van den Bosch
Peter Van den Bosch
In GitLab by @pvdbosch on Nov 20, 2019, 15:01 During presentation of the REST guide to Flanders, there was some feedback on naming: * resource archetype "Document": would "Entity" be...
In GitLab by @pvdbosch on Dec 11, 2019, 21:01 Most gCloud business data types in Swagger/OpenAPI are related to concepts defined in functional work group, (international) standards or, in the...
In GitLab by @wsalembi on May 13, 2019, 11:25
When deciding on the guidelines for the schema of identifiers, one of the [arguments](https://github.com/belgif/rest-guide/wiki/integer-vs.-string-for-numerical-codes-and-identifiers) was that integer type leads to less errors when both representations with and without leading zeros...
Add a rule on examples: * add examples in OpenAPI to better document it. These MUST be schema-valid. * being more specific is properly overkill (e.g. if examples should always...
Document that properties can't have explicit value `null` unless schema declares `nullable: true` in OAS 3.0. Can be added to [[jsn-null]](https://www.belgif.be/specification/rest/api-guide/#rule-jsn-null). In OAS2.0/Swagger null wasn't allowed at all (or ambiguously...
Now that the validator is available as open source, we should add it to the build of each belgif openapi project. _edit_: Also configure dependabot to keep version up to...
How to design query operations across all child resources of a parent type? E.g. when there's a resource type "meeting" which can have a number of invitees. An invitee points...
Also adds some paragraph titles to intro section
cfr mail jpraet of 13/3 * communication before WG meeting to improve meeting preparation * PR reviews not during meetings * focus meetings * task assignment