Skip to content

research: netlify - Finalise README proposal and assess deployment settings #463

Open

Description

@ashleyshaw

Requested outcome

Finish the proposed .github/README.md for lightspeedwp/ThisOneTimeOnAcidCom, updating historical findings against current repository evidence.

Assess Netlify runtime, build settings, package-manager consistency, redirects and branch alignment. Recommend fixes with verification and recovery requirements. Deployment or configuration remediation requires separate approval before implementation.

Verified context

  • Related Linear work: task: repository-setup - Establish repository configuration and contribution structure #13 provides the historical documentation scope. Existing deployment and governance work must be reviewed before recommending additional implementation.
  • Repository/environment: lightspeedwp/ThisOneTimeOnAcidCom; Netlify-hosted website.
  • Inspected revision: develop at 3f583002482d80ffd1910676bcf7c63e13989b20.
  • Instructions: Repository AGENTS.md, CONTRIBUTING.md, branch validation and relevant operational documentation.
  • Current evidence: Root netlify.toml exists with npm run build, dist and Node 24. Nested src/app/netlify.toml is absent. public/_redirects is a regular file. npm-only and Node 24 decisions are recorded; do not reopen them without conflicting evidence.
  • Limitations: Live Netlify settings, deployed SHA, effective runtime and browser routing remain unverified. Historical deployment observations are not current production evidence.
  • Source proposal: Pasted documentation proposal and findings.

Inspect each repository independently; do not assume shared deployment conventions.

Scope and boundaries

  • Included: README completion; effective Node/npm versions; build command and configuration precedence; application lockfile consistency; SPA redirects; production branch and deployed revision.
  • Excluded: Configuration changes, dependency installation or updates, lockfile regeneration, workflow/template/ownership edits, production branch changes and deployment.
  • Dependencies: Current organisation community-health sources, existing implementation work and access to live Netlify evidence.
  • Safeguards: Preserve unrelated work. Exclude secrets and environment-variable values. Do not create test issues or pull requests.

Assessment and proposed plan

  • Compare current repository files, operational documentation and live settings; distinguish stale documentation from operational defects.
  • Complete the README inventory, community-health inheritance and local overrides, ownership boundaries, automation responsibilities and outstanding checks.
  • Verify shared sources before describing inherited behaviour; do not infer required checks, active auto-merging or PR-template population.
  • Assess each deployment risk against the effective production configuration and deployed SHA.
  • Recommend changes only where evidence establishes a remaining gap, including dependencies, verification, rollback and safe-stop requirements.
  • Record ownership decisions and handover needs without inventing owners, costs or dates.

Mark checks as passed, failed, pending, not run or not applicable. Static inspection is not an executed operational check.

Recommendation and handoff

  1. Complete and review the README against current source evidence.
  2. Verify effective production settings, deployed revision and routing.
  3. Present prioritised remediation proposals for separate approval, reusing existing implementation issues where appropriate.

The assessment and recommendations belong in this issue; no separate document or follow-up issues are created automatically. Description links do not establish native relationships.

Branch instructions

  • Repository: lightspeedwp/ThisOneTimeOnAcidCom
  • Base: develop
  • Branch: Unresolved. task/repository-setup-toa-13 is a historical proposal, not an approved existing branch.
  • Classification: Future README implementation is documentation work, independently of this issue’s Research classification.
  • Policy conflict: Historical scope prescribes task/; documentation work supports docs/. A required local branch-policy reference is missing. Resolve these before branch creation.
  • PR template: Read the shared pr_docs.md before implementation; automatic population remains unverified.
  • Expected file change: Create .github/README.md only.
  • Gates: Obtain exact branch approval and validate its name before creation or edits. Preserve unrelated changes. Do not commit, push, open a PR, merge or deploy without approval.
  • Closing targets: None. README completion does not establish completion of the broader historical issue.
  • Scope-change gate: Stop for revised scope and approval before changing additional files.

Acceptance criteria

  • Scope and repository revisions are traceable to evidence.
  • Requirements, alternatives, dependencies and risks are recorded.
  • Verification, recovery and approval requirements are explicit.
  • Recommendations, unknowns and implementation handoff are clear.
  • README content reflects current configuration and distinguishes verified behaviour from pending checks.
  • All five deployment risk areas have evidence-backed findings; no configuration fixes are implemented without separate approval.

Definition of Ready

  • The requested planning outcome and available sources are identified.
  • Material access gaps and environment assumptions are recorded.

Definition of Done

  • The assessment and plan address the requested outcome.
  • Evidence, limitations, outstanding decisions and handoff are recorded.
  • Unverified checks are not presented as passed.

Planning completion does not authorise commands, infrastructure changes, deployments or commercial commitments. README implementation remains subject to the branch and execution gates above.

Activity

  1. self-assigned this
    on Oct 24, 2026
  2. linear-code commented on Oct 24, 2026

    @linear-code
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Fields

Priority

None yet

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions