Repository navigation
SB 8.1 docs - #193
Merged
Merged
SB 8.1 docs#193
Conversation
The generated spec loses the hand edits from earlier releases on every
download. scripts/sb_spec_fixes.py re-applies them: the ledgeraccounts 2.0
response schema, the salesinvoice VatType/ToBeInvoiced texts, and the
ReadKey and chunked upload documentation on /api/blob/{uuid}.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Explains how to download a blob with the ReadKey header, how long a ReadKey is valid and which errors to expect, and how to upload a file in chunks with Content-Range and x-blob-completed. Adds C# examples for both. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
8-1-0.json is release-spec.json with the examples from OpenApiSpecs/sb/files merged in by merge_openapi_examples.py. Also aligns the previous/older labels so the four versions before the current one are 'previous' in both languages. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The frontmatter date check expects '---' on the first line and reports 'No frontmatter found' when the file starts with a BOM. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
De verplichte voorbereidingsheader in het schema conflicteert met de beschreven upload- en afrondingsrequests.
2 open issues
What changed in this PR
Deze PR actualiseert de SB-documentatie naar versie 8.1 en verduidelijkt het downloaden en uploaden van blobs.
review nodig: ja
labels: 🏗️ infra
Changes:
- Werkt de releasespecificatie en versiemenu’s bij naar 8.1.
- Voegt een script toe om handmatige specificatiecorrecties opnieuw toe te passen.
- Breidt beide blobhandleidingen uit met ReadKey-uitleg en chunkuploads.
| File | Description |
|---|---|
| scripts/sb_spec_fixes.py | Automatiseert specificatiecorrecties. |
| OpenApiSpecs/sb/nl/release-spec.json | Actualiseert versie en blobdocumentatie. |
| menustructures/sb_openapi_specs_menu.json | Markeert 8.1.0 als huidige versie. |
| markdownpages/sb/nl/blobs.md | Breidt Nederlandse uitleg en C#-voorbeelden uit. |
| markdownpages/sb/en/blobs.md | Breidt Engelse uitleg en C#-voorbeelden uit. |
Review effort: Balanced
Rein de Jager - REJA (reindejager)
requested a review
from Eric Zwaal (ezw2000)
October 19, 2026 13:10
Eric Zwaal (ezw2000)
approved these changes
Oct 20, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentatie-update voor SB 8.1.
Spec
release-spec.jsonbijgewerkt naar 8.1 (stable, 14 oktober). Geen functionele API-wijzigingen ten opzichte van 8.0.scripts/sb_spec_fixes.py. Past de handmatige correcties uit eerdere releases opnieuw toe na elke download: het response-schema van ledgeraccounts 2.0, de typefouten in salesinvoice (VatType, ToBeInvoiced) en de documentatie van ReadKey en chunked upload op/api/blob/{uuid}. Voor ledgeraccounts en salesinvoice zijn POA's ingestuurd om het bij de bron op te lossen.nl/8-1-0.jsonenen/8-1-0.json: release-spec met de voorbeelden uitOpenApiSpecs/sb/files(viamerge_openapi_examples.py). Alle voorbeelden uit 8.0 zijn aanwezig.Blobs-pagina (NL en EN)
ReadKey: header of query, geldigheid en foutmeldingen.Content-Rangeenx-blob-completed, met C#-voorbeeld.Geen release notes voor 8.1: er zijn geen API-wijzigingen.
🤖 Generated with Claude Code