Skip to main content

Document metadata

Status
Review candidate
Approval
Pending
Version
1.0
Classification
PUBLIC
Owner
Lightning IT Documentation Maintainers
Approver
Lightning IT Product Owners
Audience
maintainers, architecture reviewers, implementation owners, security and compliance reviewers
Last reviewed
Next review
(Annual)

Integrated documentation architecture package

This review candidate integrates the planning outputs for Goal Issue #15. It does not authorize implementation, production configuration, deployment, Domain Name System (DNS) changes, credential creation, migration, or publication. Implementation remains blocked until an authorized human records the exact decision required by Issue #38.

Package identity

FieldBound value
source branchprotected develop
source commitabef1fcc31097051aabefcbddb5f43647c67df72
architecture issues#23–#38, excluding unused numbers in that range
implementation issues#132–#142, existing #40, and existing #115
manifest algorithmSHA-256 of each file; complete digest/path lines sorted in byte order; complete text hashed with SHA-256
package manifest digest30f44a7e31ce6ddf34a6a4361fc6f160b5d81c18bd031393b17224bedf9aee1c
package statusreview candidate; human decision pending

The manifest digest covers the 18 authoritative files listed below at the source commit. This integration page and its pull request provide the review record around that immutable input set. Any content change to a listed file, change to the file set, or change to a material decision invalidates this candidate and requires a new digest and review.

Authoritative artifact register

IssueAuthoritative artifactAccountable ownerPackage purpose
#23Current-state assessmentDocumentation Maintainersverified baseline and gap inventory
#24Governance, release, and licensing baselineDocumentation Maintainersgovernance and publication baseline
#25Target documentation platformDocumentation Maintainerstarget platform and repository architecture
#26Information architectureDocumentation Maintainerscanonical structure, routes, and navigation
#27Metadata and lifecycle modelDocumentation Maintainersidentity, status, approval, and lifecycle schema
#28Product documentation standardDocumentation and Product Ownersreusable product/page contract
#29Trust Center modelTrust Ownerpublic trust topics and claim boundaries
#30Evidence Center modelEvidence Ownerevidence records, states, and retention
#31Compliance mapping modelCompliance Ownerframework-neutral mappings and claim safety
#32Public/private security architectureSecurity and Compliance Maintainerspublication and threat boundaries
#33Localization and search strategyDocumentation and Locale Ownerslocale lifecycle and deterministic search
#34GitHub lifecycle traceabilityRepository Maintainerimmutable public lifecycle graph
#35CI/CD and Cloudflare architectureDelivery Engineer and Production Ownersbuild-once delivery, acceptance, and rollback
#36Migration plan and inventoryMigration Ownerclassified migration decisions and sequencing
#37Dependency graph and implementation planArchitecture and Implementation Ownersmilestones, work issues, and approval gate
ADRsIntegration decisions and GitHub automation trustDocumentation and Repository Maintainersaccepted architecture decision records

The architecture index remains navigation, not a competing source of truth. Each topic above has one authoritative artifact. Cross-links do not transfer ownership or approval.

Completeness against Goal #15

Required capabilityAuthoritative coverageDisposition
platform, repository, and Docusaurus architecture#25resolved architecture
information architecture, routes, navigation, and page standard#26 and #28resolved architecture
product and cross-product documentation model#26 and #28resolved; implementation in #135
metadata, versions, ownership, approval, and lifecycle#27resolved; implementation in #133
Trust, Evidence, and Compliance Centers#29, #30, and #31resolved; implementation in #136–#138
public/private, security, privacy, and claim boundaries#24 and #32resolved architecture
localization and search#33resolved; implementation in #139
GitHub and engineering-lifecycle traceability#34resolved; implementation in #140
CI/CD, Cloudflare, DNS/TLS, acceptance, and rollback#35resolved; implementation remains gated
migration inventory and plan#36resolved plan; execution in #141
dependencies, milestones, and bounded implementation issues#37 and #132–#142resolved plan; all issues remain Todo
production platform delivery#40existing external implementation issue
Platform Governance & Evidence content#115existing product delivery issue
approval authority and exact document approval#2open and independently blocking

No Goal #15 capability is treated as implemented merely because its architecture is complete.

Consistency review

ConcernPackage-wide invariantResult
product modelModuLix, IO, Wunderbox, and Atlas are peer products; foundation topics are cross-productpass
publication boundaryonly PUBLIC or independently reviewed PUBLIC_AFTER_SANITIZATION may publish; uncertainty remains privatepass
document identitystable IDs and canonical routes are unique; aliases use one-hop redirectspass
lifecycle terminologystatus, approval status, version, owner, approver, review, supersession, and retirement retain one meaningpass
approvaltechnical checks and AI review never substitute for role-authorized, exact-digest human approvalpass
evidencemissing, failed, withheld, expired, revoked, and superseded evidence never becomes implicit successpass
compliance claimsmappings explain relationships and never assert certification, conformity, audit success, or risk acceptancepass
localizationEnglish is the operational source/fallback; translated publication requires owned human reviewpass
searchdraft, restricted, stale, and unsupported content is partitioned or excluded according to explicit policypass
traceabilitymutable GitHub metadata is an observed snapshot; claims bind to immutable identitiespass
deliveryone validated artifact is promoted unchanged; preview and production remain separated and protectedpass
migrationevery source receives an explicit public-safe disposition; private content never enters this repositorypass
phase gatearchitecture approval in #38 precedes implementation; production has additional independent gatespass

The review found no unresolved contradiction between the authoritative artifacts. Implementation must preserve these invariants and return any new consequential decision to architecture review.

Decision log

Resolved

  • Keep Docusaurus and the existing public repository rather than redesigning the platform from scratch.
  • Preserve the four-peer-product model and use cross-product foundation sections for shared engineering, trust, evidence, compliance, and support.
  • Use explicit canonical ownership, stable routes, controlled metadata, and independent approval bound to deterministic document digests.
  • Separate public summaries and indexes from protected evidence and private operational records.
  • Use framework-neutral compliance mappings without unsupported assurance claims.
  • Use public GitHub metadata through an allowlist and immutable identifiers; never query private repositories from public workflows.
  • Build once, promote the same artifact, use Cloudflare Pages Direct Upload, and keep production mutation behind protected environments and acceptance.
  • Execute implementation through #132–#142, #40, and #115 only after their documented dependencies and gates are satisfied.

Deferred

  • Final service-level objectives, retention periods that require organizational authority, and provider recovery commitments remain owner decisions during their implementation issues.
  • The exact production credential identities, account identifiers, zone identifiers, and protected evidence locations remain private implementation inputs.
  • Product-specific content depth and translation rollout order are decided in the bounded implementation and migration issues, within the approved models.
  • Production approval evidence and maintained document status remain deferred to #2 and the exact release candidate.

Rejected

  • Publishing private repositories, customer material, credentials, internal operations, risk registers, raw audit evidence, or restricted findings.
  • Treating a closed issue, green workflow, AI review, mutable badge, or generated date as sufficient human approval or runtime proof.
  • Cloudflare Git-based rebuilds for promotion, unpinned deployment clients, administrator bypasses, and token exposure to untrusted pull requests.
  • Empty placeholder centers, invented evidence, silent translation fallback, silent partial GitHub data, and unsupported certification claims.
  • Starting implementation merely because this package exists or #38 closes without the exact explicit authorization.

Maintainer-owned decisions

  • Approve or reject this exact package and, if approved, explicitly authorize the implementation phase in #38.
  • Complete the role-to-identity authority decision and exact document approval record required by #2.
  • Approve any material taxonomy exception, publication-boundary exception, production change, DNS/TLS mutation, credential use, residual-risk acceptance, or legal/compliance claim through its own authorized gate.

Risk and assumption register

IDRisk or assumptionStatus and control
R-01restricted information could enter public content, evidence, cache, search, or logsblocking; #32 boundary, classification, sentinels, review, and fail-closed generation
R-02architecture documents could be mistaken for implemented or production behaviorcontrolled; review-candidate metadata and explicit implementation verification
R-03mutable metadata or stale evidence could support a misleading claimcontrolled; immutable IDs, observation times, lifecycle states, review, and digest binding
R-04route/schema changes could break published references or approvalscontrolled; compatibility, one-hop redirects, inventories, and migration fixtures
R-05deployment rebuild, drift, or credential scope could break artifact identity or least privilegeblocking at delivery; #35 preflight, protected environments, Direct Upload, evidence, and rollback
R-06single-maintainer operation reduces human independenceaccepted only within the documented compensating control; never extends to legal/risk authority
R-07#2 authority and exact document approval are incompleteopen blocker for maintained release and production publication; no substitute is permitted
A-01Node 24.18.0 and the currently pinned package set remain available during implementationverify in #132/#40; architecture review if the toolchain materially changes
A-02public GitHub and Cloudflare capabilities used by the design remain availableverify through read-only preflight; fail closed on incompatible provider change
A-03accountable roles can supply bounded private decisions without publishing protected detailsverify at each gate; absence blocks the affected work

No risk acceptance is asserted by this public record. Only the authorized owner may accept a residual risk, and protected details remain outside this repository.

Dependency and authorization state

Architecture issues #23–#37 are complete and integrated. The implementation issues #132–#142 are open sub-issues of #15, in milestone docs.l-it.io Foundation v1.0, labeled phase:implement, and held at project status Todo. Existing issues #40 and #115 retain their own acceptance criteria.

Issue #2 remains open. It requires authorized identities, role-matched decisions, an exact final documentation-tree digest, and a passing approval test. Its remaining constraint blocks maintained document approval and production publication. An architecture decision in #38 does not close, waive, or substitute for #2.

The authorized maintainer must review this complete package, the source commit, the manifest digest, the issue breakdown, and the open constraints. Until that human records an explicit implementation authorization in #38:

  • #132–#142, #40, and #115 remain blocked;
  • no implementation branch or pull request may start;
  • no production, DNS, credential, migration, or external-source mutation may occur; and
  • closure, merge, or an automated comment is not approval.

If the package is rejected, #38 records the rejected decisions and returns the affected artifacts to their accountable owners. If it is approved, each implementation issue may proceed only when its own dependencies and safety gates are also satisfied.