Skip to content

docs: make AS Coaching approachable for new contributors - #303

Merged
devantler merged 1 commit into
mainfrom
codex/docs-onboarding-ascoaching-302
Oct 12, 2026
Merged

devantler merged 1 commit into
mainfrom
codex/docs-onboarding-ascoaching-302

Conversation

@devantler

Copy link
Copy Markdown
Contributor

🤖 Generated by the Agentic Engineer

Why

New contributors need a clear local starting point and accurate ownership of the website's content and booking address. They should not need platform access or contact real clients to check a small improvement.

What

Provide reader-focused Danish setup and contribution guidance, correct the existing source-ownership descriptions, and protect the tailored guides from later template synchronization. Preserve accessibility, browser compatibility and delivery checks.

Fixes #302

@devantler

Copy link
Copy Markdown
Contributor Author

🤖 Generated by the Agentic Engineer

The documentation-only slice was checked against base ff0a22d. An independent reader used a fresh anonymous checkout with only the four draft files copied and owned dependency/browser caches. Installation, lint, typecheck, 54 unit tests, 13 browser tests, explicit build and all five documented wiring fixtures passed. Four local links/anchors and eight shell blocks passed, and all four guide digests match this slice.

The required Lighthouse infrastructure completed three runs successfully without changing its policy. LCP retained a warn-level budget miss (2705.9–3003.6 ms against 2500 ms); performance scores were 0.94–0.95. This is not a claim that every performance budget passed. Dev and built previews both navigated Services, About and Contact to the correct sections, with empty contact fields; no real email, booking or external contact action occurred. Screenshots were unavailable, so the evidence is a DOM/user-path trial, not visual screenshot QA.

Nested-worktree lint, typecheck, explicit build and the five local wiring fixtures passed. Its unit runner failed during optimizer startup before tests ran; that did not reproduce in the independent standalone checkout. The initial reader's duplicate npm-isolation config paths were corrected only in its disposable harness; source, setup commands and checks were not changed. Existing host tools are not fresh-host proof, and local browser assertions are not an actual Safari session, container-runtime validation or deployment proof. All owned trial processes, listeners and disposable files were cleaned up.

@devantler

Copy link
Copy Markdown
Contributor Author

🤖 Generated by the Agentic Engineer

@coderabbitai full review

@coderabbitai

coderabbitai Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
✅ Action performed

Full review finished.

@coderabbitai

coderabbitai Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: 8087c57d-872d-4dcf-86a7-b99ee7e732f4


📥 Commits

Reviewing files that changed from the base of the PR and between ff0a22d and 6caf713.



📒 Files selected for processing (4)
  • .templatesyncignore
  • AGENTS.md
  • CONTRIBUTING.md
  • README.md


Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.



📜 Recent review details
🧰 Additional context used
📚 Code guidelines (2)
CLAUDE.md — auto-discovered
README.md — auto-discovered

📓 Path-based instructions (2)
`@AGENTS.md`

📄 CodeRabbit inference engine (CLAUDE.md)

Files:

  • AGENTS.md

Source excerpt: Source excerpt: Åbn [http://localhost:5173](http://localhost:5173).

📄 CodeRabbit inference engine (README.md)

Files:

  • AGENTS.md
  • README.md

🧠 Learnings (1)
📓 Common learnings
Learnt from: CR
Repo: devantler-tech/ascoachingogvaner

Timestamp: 2026-10-12T00:36:01.640Z
Learning: Source excerpt:
# AGENTS.md

## Validation

The required documentation guard scans only README.md and AGENTS.md, with its scope declared in .github/retired-repo-links.json. Run `bash scripts/retired-repo-links.test.sh` locally to verify the scope and required CI registration. The native job uses the shipped validator and checks a clean scan, a seeded retired link, and missing configuration; it also runs on main after merge.



🔇 Additional comments (5)
CONTRIBUTING.md (2)

87-88: 🎯 Functional Correctness

Keep the Lighthouse required-check statement.

.github/workflows/ci.yaml includes lighthouse in CI - Required Checks and aggregates needs.lighthouse.result. The warn-level budget configuration does not make the job optional.


112-113: 🗄️ Data Integrity & Integration

The ownership statement is supported. .templatesyncignore lists README.md, CONTRIBUTING.md, and all files in its tenant-owned section. No coverage gap remains.


.templatesyncignore (1)

13-13: LGTM!


AGENTS.md (1)

26-26: LGTM!

Also applies to: 45-45


README.md (1)

66-67: 📐 Maintainability & Code Quality

The comment does not establish a documentation defect. The requested command did not complete because yq was unavailable, and no exact-head CI result is supplied. The command without a validator argument checks wiring only; the documentation scan is optional in the script.





📝 Walkthrough
📝 Walkthrough

Walkthrough

The README and AGENTS.md now describe the static site, local workflows, and canonical booking URL source. A new Danish contribution guide covers setup, checks, ownership, and pull request requirements. .templatesyncignore now excludes CONTRIBUTING.md from template-sync overwrites.



Priority: ⬇️ Low

Merge Risk: ⚪ Minimal · up to 6caf7

The local-preview link resolves to the correct README section. No actionable issue remains in the reviewed documentation changes.


Important

Pre-merge checks failed

Please resolve all errors before merging. Addressing warnings is optional.

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Linked Issues check Inconclusive The change addresses the coding objectives in [#302]. CONTRIBUTING.md documents npm ci, required tools, repository paths, local preview and stop instructions, content and booking sources, browser … Provide the exact-head review and required CI gate results for head 6caf71337c13b669d8e6624063d7a6f42ceb44b8, including any failed or unavailable checks.
✅ Passed checks (4 passed)
Check name Status Explanation
Out of Scope Changes check Passed The changes stay within [#302]. They add the requested Danish contributor guide, revise README and source-ownership guidance, update the canonical booking-source description, and protect the tenant-ow…
Docstring Coverage Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Title check Passed The title clearly describes the main documentation change: making AS Coaching more approachable for new contributors.
Description check Passed The description is directly related to the documentation, contributor guidance, source ownership, and template-sync protection changes.

Full details: Linked Issues check

Explanation

The change addresses the coding objectives in [#302]. CONTRIBUTING.md documents npm ci, required tools, repository paths, local preview and stop instructions, content and booking sources, browser prerequisites, checks, and privileged CI/deployment work. README.md and AGENTS.md update the related workflow and source descriptions. .templatesyncignore protects CONTRIBUTING.md. The reported independent-reader checks support the documented paths, and the report does not claim unavailable checks as passed. The available evidence does not establish that normal exact-head review and CI gates passed for head 6caf71337c13b669d8e6624063d7a6f42ceb44b8.


  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@devantler

Copy link
Copy Markdown
Contributor Author

🤖 Generated by the Agentic Engineer

@coderabbitai The inconclusive Linked Issues check requested exact-head review and CI evidence; that evidence is now complete at 6caf713, base ff0a22d.

Your substantive full review covers all four changed files and states that no actionable issue remains: #303 (comment). All five additional observations were inspected and request no source correction. The native CI run https://github.com/devantler-tech/ascoachingogvaner/actions/runs/38188471608 completed successfully, including unit and browser tests, build, required Lighthouse infrastructure, container smoke and CI - Required Checks. Native dependency review, CodeQL and workflow scanning also pass; there are no failing or pending applicable checks and GitHub reports CLEAN. There are no review threads. The prior local optimizer failure, reader limitations and warn-level Lighthouse metrics remain explicitly recorded in the validation comment, not described as passed or diagnosed.

The required-gate helper confirms the CI aggregate and required workflows; its configured code-quality rule remains API-UNVERIFIED, separately from native successful CodeQL and GitHub's authoritative CLEAN enforcement. The live holder is self and the exact-head claim verifies. Fresh complete WIP is Verifying 2/3 and Ready to Merge 0/6; only development/review WIP is excepted. The repository PR template is preserved. This evidence satisfies the report's missing delivery-proof request without changing source, skipping checks, buying review credits or claiming every performance budget passed. Ready for promotion, then a fresh native merge check.

@coderabbitai

coderabbitai Bot commented Oct 12, 2026

Copy link
Copy Markdown

Tip

For best results, initiate chat on the files or code changes.

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail
repo="devantler-tech/ascoachingogvaner"
head="6caf71337c13b669d8e6624063d7a6f42ceb44b8"
gh pr view 303 --repo "$repo" --json url,state,isDraft,headRefOid,baseRefOid,mergeStateStatus,reviewDecision,statusCheckRollup
gh api "repos/$repo/issues/comments/6115712750" --jq '{user: .user.login, body, html_url}'
gh api "repos/$repo/actions/runs/38188471608" --jq '{head_sha,status,conclusion,html_url,event}'
gh api --paginate "repos/$repo/commits/$head/check-runs?per_page=100" --jq '.check_runs[] | {name,status,conclusion,head_sha,details_url}'
gh api graphql -f query='query { repository(owner:"devantler-tech", name:"ascoachingogvaner") { pullRequest(number:303) { reviewThreads(first:100) { totalCount nodes { isResolved } pageInfo { hasNextPage } } } } }'

Length of output: 29802


@devantler, I verified the exact-head evidence. It satisfies the missing review and CI evidence request from the Linked Issues check.

  • The current head is 6caf71337c13b669d8e6624063d7a6f42ceb44b8. The base is ff0a22db0e4f74f8ef3b01942adcd9bd996167c9.
  • The full review covers all four changed files and reports no actionable issue.
  • CI run 38188471608 completed successfully at that head. Tests, build, Lighthouse Budget, Container Smoke, retired-link validation, and CI - Required Checks passed.
  • Native dependency review, CodeQL, code-quality analysis, and workflow scanning passed.
  • No reported check is failing or pending. Two auto-merge workflow jobs are skipped.
  • GitHub reports CLEAN. There are no review threads.

The recorded Lighthouse warnings and local validation limits remain separate from successful native CI results. The helper’s API-UNVERIFIED result is not evidence of a native check failure.

The earlier evidence gap is now closed. The published report still displays its earlier inconclusive result; this reply does not update that report. PR #303 remains a draft. After promotion, perform the fresh native merge check before merging.

You are interacting with an AI system.

@devantler
devantler marked this pull request as ready for review October 12, 2026 00:45
@devantler
devantler requested a review from a team as a code owner October 12, 2026 00:45
@devantler
devantler merged commit ba2179f into main Oct 12, 2026
24 checks passed
@devantler
devantler deleted the codex/docs-onboarding-ascoaching-302 branch October 12, 2026 00:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Make the Danish website guides usable for first-time contributors

1 participant