Skip to content
Historical revision — this record as it stood on 1 July 2026, not the current version. View the current record →

Editorial language registers

The three PointSav wikis address three distinct primary audiences. Each audience has different financial and technical literacy, different reasons for reading, and different vocabulary expectations. Writing in the wrong register produces content that fails to communicate — not because it is inaccurate, but because it addresses the wrong reader. This article is a reader-facing overview of the three registers; the detailed, authoritative drafting standards behind them are maintained as the organization's editorial style-guide set, which is the single source of truth that every other note on voice or register defers to. The underlying language protocol substrate enforces these rules structurally at capture time.

The editorial standard

Five rules, reconciled and operator-ratified on 2026-05-21, are the editorial standard behind every register defined here. The registers below specialize these rules for a specific audience; they never relax them. Where a register rule and a rule below appear to conflict, the rule below governs.

  1. Sentence length is budgeted by sentence role. An expansion sentence — one that develops a mechanism or an argument inside a body section — runs to about 45 words at most. A disclosure sentence — the lede, a compliance claim, a regulatory statement — runs to 25 words at most. Vary the rhythm: every paragraph carries at least one short declarative sentence, so the prose reads as an accordion rather than a monotone.
  2. Active verbs describe present-fact mechanism. Use the active voice to describe how something works now. Do not use it to assert a forward-looking claim as accomplished fact — capability, timeline, or outcome that is not yet true keeps planned, intended, may, or target. Do not give a system human intent or feeling. There is no ban on is, are, or was: a plain copula is correct when the sentence states a fact.
  3. Analogy is a ceiling, not a quota. An analogy is optional. Where one is used, hold to at most one per 300 words. Prose with no analogy is fully compliant; prose that reaches for an analogy in every paragraph is not.
  4. The lede is the nut graf; the Franklin arc orders the body. The front-loaded four-paragraph lede carries the news in roughly the first 10% of the article. The Franklin arc — Crisis, then Quest, then Breakthrough — governs the order of body sections only. It never displaces the lede or delays the news.
  5. The SaaS-marketing register is rejected. Public content does not adopt the promotional voice of a software-product landing page. Internal codenames — "Liquid Glass" among them — stay internal; they do not appear in public content.

What a register is

A language register is the combination of sentence structure, vocabulary, depth, and tone appropriate for a specific audience in a specific context. A financial brief uses a different register than a technical specification. Institutional financial journalism uses a different register than a building code. Developer-platform documentation uses a different register than either. The PointSav wikis are written in three distinct registers — one per audience — applied consistently across every article.

Register is not style preference. It is the difference between a reader who understands what they came to learn and a reader who gives up and closes the tab.

Audience map

Wiki Primary audience Secondary audience Register
content-wiki-corporate Bankers, family offices, institutional investors C-suite principals, corporate advisors Institutional financial-press register
content-wiki-projects Top-400 development firms, commercial architects, construction programme managers Same institutional investors reading project subject matter Institutional financial-press register
content-wiki-documentation Software engineers, graphic designers, platform developers Emerging institutional readers evaluating technical credibility Developer-platform register primary + Corporate accessibility layer
bim.woodfinegroup.com Architects, engineers, building code officials Regulatory specification register
gis.woodfinegroup.com GIS analysts, co-location programme managers Technical specification
design.pointsav.com Design system contributors, component authors Design specification (DTCG, component API)

The corporate and projects wikis share a register because they share a primary audience. The subject matter shifts — corporate governance and capital structure versus real estate development programmes and co-location markets — but the reader's financial literacy and capital-allocation frame does not. A family office principal reading about direct-hold tax structures and then reading about co-location development sites is the same person applying the same evaluative frame to different subject matter.

Register 1 — Institutional financial-press register

Applies to: content-wiki-corporate and content-wiki-projects

The reader is an institutional decision-maker. They have financial literacy and no obligation to understand software architecture or building codes. They are reading to make a capital allocation decision or to evaluate the platform's sponsors and structure.

Rules:

  • Sentence length: 14–18 words target; 25-word hard limit
  • Lead structure: consequence first — the most important fact for a capital allocator goes in sentence one
  • Voice: active. Passive voice hides responsibility and reads as evasion.
  • Numbers: always specific. "$7 per month" not "low cost." "Top-400 development markets" not "major markets."
  • Jargon: translate everything on first use. Platform-internal terms do not appear without a plain-language equivalent immediately preceding them.
  • Code blocks: never. The corporate and projects reader does not need to see terminal commands.
  • Citations: financial research, regulatory filings, industry reports, market data
  • Avoid: academic hedging, abstract nouns, dramatic marketing claims, platform-internal metaphors

Consequence-first pattern:

"The Direct-Hold framework removes the pool. Each property is its own legal and financial unit."

"Each co-location development site is underwritten as an independent capital event. Woodfine does not pool site performance — convergence at a node is validated independently before capital is committed."

Same reader, same register, different subject matter.

Register 2 — Developer-platform register + Corporate accessibility layer

Applies to: content-wiki-documentation

The primary reader is a software engineer, designer, or developer. They have technical literacy and are reading to understand how the platform works, how to deploy it, or how to contribute to it. The secondary reader — increasingly important — is an emerging institutional reader: a bank's technology committee, a family office's incoming principal, a senior developer from a Top-400 firm who is evaluating whether the platform is credible enough to approve or fund. This reader is technically literate — they can read code — but does not know the platform's internal vocabulary.

Rules:

  • Structure per section: Concept → Why it matters (one sentence, consequence-first, no jargon) → How it works → Code → Edge cases
  • The "why it matters" sentence must stand alone for the institutional reader scanning section headers — it is the Corporate accessibility layer
  • Code blocks: real and runnable. If abbreviated, mark with # ...
  • Field jargon (gRPC, systemd, JSON, async): use freely — no need to explain
  • Platform-specific terms: define once in plain language on first use, then use the term
  • Tone: peer-level, confident, direct — engineer to engineer
  • Avoid: over-explaining basics (HTTP, SSH, git), vague architecture descriptions, incomplete examples

Accessibility layer pattern:

"service-slm routes every AI request to the cheapest compute tier that meets the deadline, without the caller specifying which tier. Local inference first (5 s), cloud burst second (10 s), external API last (30 s). A request that resolves locally never leaves the customer's infrastructure — and never appears on a cloud billing statement."

The last sentence is the Corporate accessibility layer. An institutional reader scanning section headers gets: "it can run locally, and you pay nothing when it does."

Register 3 — Regulatory specification register

Applies to: specialist deployment sites only — bim.woodfinegroup.com, gis.woodfinegroup.com, design.pointsav.com

Prescriptive specification language (shall / shall not for requirements, measurements with units, normative vs informative distinction, standards citations, in the tradition of building-code and interoperability standards bodies) is the correct register for the specialist sites. It does not appear in the three main wikis because the main wiki audience is the institutional decision-maker, not the compliance engineer. "Shall" language reads as aggressive to a capital allocator. Specification language signals "compliance document," not "credible platform."

Specialist sites as cross-reference destinations:

When a main wiki article references a topic requiring prescriptive specification, link to the relevant specialist site:

  • "For full climate zone token specifications and IFC mappings, see bim.woodfinegroup.com."
  • "For co-location scoring methodology and zoning criteria, see gis.woodfinegroup.com."
  • "For design token schemas and component specifications, see design.pointsav.com."

These sites are canonical reference destinations, in the same way that Wikipedia articles link to technical standards — the main article is readable by a general audience; the specialist site is where you go to build or verify.

Vocabulary retirement

These terms appear in current wiki articles written for an internal engineering audience. They must be translated for any externally-facing article.

Retire Replace with
Substrate the data layer / the platform code / the security foundation
Doctrine architectural principle / design decision / engineering policy
Compounding training signal aggregation / model improvement over time
Leapfrog designed to exceed / targeted to replace / planned for [date]
Doorman access-control gateway / AI request router
Ring 1 / Ring 2 / Ring 3 archive tier / data tier / inference gateway
Totebox property archive / data vault
Yo-Yo pool on-demand GPU instances / ephemeral inference nodes
Sovereign (adjective) independently verifiable / operator-controlled
Compounding Substrate the platform (first use); link to architecture article
Apprenticeship Substrate the learning pipeline / the training system
LadybugDB property graph database / the DataGraph store

Rule: Retired terms may appear in architecture and services articles in the documentation wiki where they are being explicitly defined. They must not appear in corporate wiki, projects wiki, or GUIDE content without a plain-language translation immediately preceding them.

See also

Important Information

Important Information

Corporate structure. PointSav Digital Systems ("PointSav") is a trade name of Woodfine Capital Projects Inc. ("Woodfine"). PointSav does not itself offer, sell, or solicit any security. Any securities offering associated with Woodfine's real-property direct-hold solutions is made exclusively by Woodfine, and only by means of the applicable Private Placement Memorandum.

No investment advice. This wiki's content is provided for engineering, operational, research, and development purposes. Nothing on this wiki constitutes investment advice or a solicitation to invest in any Woodfine partnership or direct-hold solution.

Intellectual property. The PointSav name, trade name, wordmark, and marks, together with all current and future PointSav- and Totebox-branded products, services, and offerings — and the software, source code, documentation, design system, and all related materials — are proprietary to Woodfine and its affiliates, except for components identified as open source. No rights are granted except as expressly set out in a written license or agreement. See TRADEMARK.md in this repository for the full trademark notice.

Open source components. Portions of the platform are made available under permissive open-source licenses identified in the accompanying repository. Use of those components is governed by their respective license terms.

No warranty; informational use. Content on this wiki is provided for general informational purposes only and does not constitute a representation, warranty, or commitment with respect to product functionality, availability, pricing, or roadmap. Some articles describe planned or intended features, capabilities, and milestones — language such as "planned," "intended," "targeted," "may," and "expected" marks this forward-looking content, which is subject to change and does not constitute a commitment regarding future performance.

Confidentiality. Where an article describes an operational or deployment detail that is not intended for public disclosure, that article is not published on this wiki. Content here is general-purpose engineering documentation, not customer-specific configuration.

Jurisdiction. Woodfine Capital Projects Inc. is organized in British Columbia, Canada. References to the Sovereign Data Foundation on this wiki describe a planned or intended initiative only, not a current equity holder or active governance body.

Changes to this notice. PointSav may update this notice from time to time; the version posted on this page governs.

Not a filing system. This wiki is not a securities filing system, an electronic disclosure repository, or a substitute for SEDAR+ or any other regulatory filing system. Formal securities filings are made through the applicable regulatory filing system, not through this wiki.

Full disclaimer. This notice supplements, and does not replace, the full Disclaimers article. In the event of any conflict, the full Disclaimers article governs.

Read the full disclaimer →