Document approved external addons (gobl.fr.ctc) - #56
Draft
alvarolivie wants to merge 2 commits into
Draft
Conversation
GOBL is moving addons out of core into standalone modules (invopop/gobl#847 extracts the French CTC addons to github.com/invopop/gobl.fr.ctc). Without changes here, those addons would silently disappear from the docs on the next regeneration. - Import external addon modules in cmd/generate so their definitions register and the existing addon generator documents them like bundled ones. - Guard: fail generation if an addon on gobl's approved external-addon list (tax.ApprovedAddons) is not loaded, so newly approved addons can't be forgotten here. - Mark external addon pages with an Info callout linking the implementing module, and explain external addons in the overview. - Regenerate from gobl@fr-ctc-extract + gobl.fr.ctc: adds fr-ctc-v1, fr-ctc-flow6-v1 and fr-ctc-flow10-v1 pages, refreshes fr-ctc-flow2-v1, and picks up the new bill lifecycle schemas (fault replaces condition). Refs GBL-68. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The previous commit lost the modified (tracked) files from its index; this completes it: generator import+guard+callout, go.mod pins, docs.json nav, overview section, and regenerated pages. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
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
1 participant
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.
Linear: GBL-68
With invopop/gobl#847, the French CTC addons move out of GOBL core into
github.com/invopop/gobl.fr.ctc. Since this site generates addon pages from the runtime registry of the pinned gobl module, externalized addons would silently vanish from the docs on the next regeneration. This PR makes external addons first-class in the docs pipeline:cmd/generate— theirinit()registers the addon defs, so the existing addon generator documents them exactly like bundled ones (extensions, scenarios, validation rules included).tax.ApprovedAddons()) is missing from the runtime registry — the approved list in core acts as the manifest of external addons these docs must cover, so approving an addon without importing it here breaks the build instead of silently dropping pages.<Info>block linking the implementing module, andaddons/overview.mdxgains an External Addons section explaining recognition vs. availability.gobl@fr-ctc-extract+gobl.fr.ctc: addsfr-ctc-v1,fr-ctc-flow6-v1,fr-ctc-flow10-v1; refreshesfr-ctc-flow2-v1;draft-0picks up the new bill lifecycle schemas (faultreplacescondition).Draft until the dependency chain completes
Pinned to pre-release pseudo-versions for now:
gobl v0.403.1-0.20260603134844-28001cd0(thefr-ctc-extractbranch of Extract fr/ctc to an external module; add approved external-addon registry gobl#847)gobl.fr.ctc v0.0.0-20260603123411-82bcb109Once #847 merges and a core tag is cut,
gobl.fr.ctcdrops its devreplaceand pins the tag; then this PR swaps both pseudo-versions for proper tags and regenerates.Converters (gobl.ubl & co.) are deliberately out of scope — they'll be handled separately (docs site links/imports converter repos directly; no converter registry in core).
🤖 Generated with Claude Code