Repository navigation
site: the PFS feature pages — concept + .pfs language reference (pubid#706) - #25
Merged
Merged
Conversation
…d#706) The concept page (prose-only) covers why one data file compiles to both engines, the module library for national adoptions, the wizard connection, the tier model and the byte-parity acceptance gate; the library reference walks the .pfs surface (sections, template language, module composition, compile-time validations, versioning, the parity harness) with every example compiled green against the real toolchain (scripts/pfs, parsanol 1.3.126): the Wxyz worked example from #706 §2, a DIN module composition, and the shipped doi/etsi/calconnect/cen definitions. Registered in the concepts order and the library index.
This was referenced Nov 14, 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.
Summary
Ships the website pages for PFS — the PubID Format Schema (
.pfs), the direction adopted in pubid/pubid#706 (Phase 1 compiler + doi spike, Phase 2 etsi + module library):/concepts/pfs(src/content/concepts/pfs.md, prose-only per the concept-page rule): why one data file compiles to the Ruby and TypeScript flavors, the corpus-is-the-spec philosophy, the tier model in plain prose (27 of 44 flavors v1-expressible, ~43.8k fixtures; ISO/IEC schemes stay coded while their inner formats ship as modules), the module library for national adoptions (the DIN/BS/NF EN-ISO story), the Conormis wizard connection (#406, no link — the repo is private and the link checker would 404), and the byte-parity acceptance gate./library/pfs(src/content/library/pfs.md, reference-shaped like the pubid-URN-scheme page): the.pfssections, the template language (presence guards, alternates), the module library with the composition rules, the compile-time validations (each rejection cites the rule), versioning (pfs: 1, fail-closed), compiling, the both-engines artifact story, the parity-harness pattern and the v1 boundaries.pfsadded to the concepts order (src/pages/concepts/index.astro, between Corpus and URN) and the reference page added to the library index's reading list.Executed snippets (the method)
Every snippet on the reference page was run against the real toolchain before shipping:
scripts/pfs compilegreen (3 positives / 3 negatives verified against the baked artifact, checksum quoted from the run);iso.inner+en.overlay+national.prefix+supplements.core) — compiles green (2 positives / 3 negatives), mirroring the shippedcen.pfsport;--ruby-outform) — executed verbatim,--ruby-outemits the 9-file flavor module;spec/pubid/doi_pfs+spec/pubid/etsi_pfs, 90 examples, 0 failures.Cross-links: concept page → reference page → pubid#706 +
definitions/README.md+definitions/modules/; reference page → the parity harness on pubid main and pubid-ts#170 (the TS-sidedoi_pfs).Test plan
npx astro check— 0 errors, 0 warningsnpm run build— 358 pages built (baseline 356 + the two new pages)npx vitest run— 435 passeddist/— 745 unique links, 0 errors